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Introducing 
Extra! Extended 


elcome to EXTRA! Extended, a software program that 
lets your PG or PS/2 communicate with an IBM mainframe 
computer. With EXTRA/, the PG performs "terminal 
emulation," meaning that the PG acts like an IBM "3270" 
mainframe terminal! 

EXTRA/ gives you the best of bothi worlds. It offers access to 
powerfuUmaihframe applications and data bases,,as well as 
access to the local processing power of a PG. And you can 
easily switch back and forth between the PG and the 
mainframe with just a few simple keystrokes. EXTRA! is 
both highly-functional and reliable, without requiring 
tremendous amounts of PG memory. 




Extra! Extended's Features 


Multiple 

Sessions 


EXTRA/ Exfettded provides you with a powerfulaisenal of 
features: it offers multiplfe sessions, windows, and printer 
emulation; and it allows you to transfer files betweemyour 
PC and the mainframe. Italso uses far less PC memory tham 
its competitors. These features and others are described in 
more detail below. 


With EXTRA!- s Multiple Sessions^ you canimniup to four 
mainframe sessions at the same time, and switch between! 
them with*a few simple keystrokes. In additionitO four 
mainframe sessions, EXTRA! provides a PC session and two 
notepad windows. You can run a PG propam in the PC 
session while continuing to work in a mainframe session^ 

The notepad windows let youi edit> save, andi copy notepads 
data to both the PG and'mainframe sessions for quick 
storage and reference. 

Multiple sessions letyou get more work done ihi less time. 
For instance, you Gan enter data imone mainframe session> 
while transfemng files imanother. However, youi probably 
won't need all four mainfmme sessions and two notepads at 
the same time. EXTRA! allows you to determine the number 
and type of sessions you want to use, and allocates only the 
PG memory necessary for the selected sessions. 



Windowing 


Printer 

Emulation 


EXTRA/ also provides "Windowing." This feature lets you 
display any combination of mainframe;,notepad and PC 
sessions at the same time on the PC screeni And withi 
EXTRA!’s window management utilities, you can adjust the 
color, size and position of the seven available windows. 
Windbws are excellent for working withi multiple 
applications. For example, you can copy data between 
windows, or monitor file transfer in one window while 
reviewing a mainframe database in another window. 


Withi Printer Emulation, you cani print mainframe data on a 
local PC printer, saving you the time; expense and 
inconvenience of using a mainframe printer. EXTRA! 
supports a wide range of PC printers, including low-cost 
printers for simplfe output or high-quality laser printers for 
more sophisticated or faster output Andi EXTRA/helps 
meet budget requirements by supporting shared ILAN 
printers. 

EXTRA! also offers a print-to*disk feature, allowing a 
mainframe print job to be routed to a PC disk. The data can 
then be used in other PC applications or printed off-line, 
significantly reducing mainframe connect time. Multiple 
sessions are especially useful for printer emulation; since 
mainframe data can be printed while you continue working 
in another session. 




EXTRA! provides three ways to transfer files between your 

PC and the mainframe: 

• Host-Supported File Transfer - EXTRi4/lets you 
transfer files toiand from the mainframe using IBM's 
mainframe-based Send / Receive (INIDSFITE) program. 
Send /Receive offers high-speed transfer of both text 
and binary files, as well as excellent error correctibni 
EXTRA.tsupports Send/Receive ih TSOi CMSy,and 
GIGS operating envitonments. 

• Personal Services/CIGS File Transfer - This option lets 
youi transfer text and binary files with lBM's Personal 
Services/CIGS., Unlike host-supported file transfer, it 
does not work with INDSFIEE Send/Receive,,am IBM 
program: Instead, PS/GIGS works with another IBM 
program called Transfer (DISOSS) to transfer files. 

• Editor-SupportediFile Transfer- This option;lets you 
transfer text files using host-based TSO and GMS 
editors. This method does not require special 
mainframe software, and; it can run in; the mainframe 
session! while your PG session runs PG applications. 


With Host-Supported and Editor-Supported File Transfer 
methods, EXTRA/ provides an easy-to-use file transfer 
interface that allbws you tb transfer files in the background. 
Transferring im the background means thatyou can initiate a 
file transfer foom your PG sessibn> and continue working on 
your PC application while the file transfers betweemthe 
mainframe and the PG. You dbnit need to load and unload 
PG applications, or wait for the file transfer to complete. 

PS/ GIGS also features an optional "background DISOSS file 
transfer" that lets you transfer files in the background; 
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Flexible EXTRA/ can communicate withi the mainframe in a variety 

Connection of ways; the method is up to you* It can be customized to 
Methods communicate with the mainframe via a coax adapter, an 

SDL€ adapter, a Local Area Network adapter, or a 
Token-ring Interface Coupler (TIC). EXTRA/ supports 
Attachmate, IBM and IRMA coax adapters, and Attachmate 
and IBM SDLC adapters. These connections are shown in 
the diagram below: 
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Display 

Ability 

EXTRA! provides wide array of display screenifeatures, 
mduding support for both cotor and monochixjme screens. 
With some adapters, you can; evemview screens larger thani 
the standard PG display (24 rows by 80 columns), so you 
wonlt need to pan andiscrolL Regardless of the screen size, 
EXTRA! delivers a flicker-free display with crisp, legible 
characters. 

Mouse 

Support 

EXTRA/provides mouse^support in both PC and mainframe 
sessions. In:£XTRA/'S mainframe sessions, you canimove 
your host Gtirsor to any mainframe field simply by moving 
your mouse pointer to the fieldi and clicking. EXTRA! also 
provides li^t pen support in the mainframe sessions, as 
well'as light pen emulation! with amouse. You can use 
EXTRA! with Microsoft> IBM, or Logitech mice/or any 
Microsoft-compatible mouse. 

Keyboard 

Support 

Sincemost offices use a variety of PC keyboards, EXTRA/ 
supports most standard PC keyboards and offers pre¬ 
defined keyboard layouts firom IBM> IRMA„Keyttonic, 

Nokia, and Attachmate. With these layouts„youicani 
upgrade to EXTRA/ and confihue using your current 
keyboard layout. 


You cani change your keyboard selection throughi 
Attachmate's customization program; EXTRA/ provides a 
variety of templates for multiple layouts, should you decide 
to create a custom keyboard. 

Mainframe 

Graphics 

EXTRA/ provides a PC graphics program which brings 
flicker-)6pee,mainframe graphics to your PC. The Host 

Graphics Option emulates IBM's 3179-G, 3192-G,,and 3279 

S3C terminals. This program is available as an optibnito; 
EXTRA! Extended. 



Low 

Memory 


Talking 

EXTRA! 


If youn systemds short onimemory, EXrJ?i4/ provides two 
features that lower the amount of memory that EXTIM/ 
uses: iLow Memory (EM) and EMS (Expanded Memory 
Speeifiication)* 

• If you do not use any oi EXTRAi's advanced features, 
you cani save memory by configuring EXT2M/ for Eow 
Memory (EM). EM is a low memory version ofEXTIlA.' 
that retains its most-frequently used features. It saves 
memory by not taking up additional RAM for features 
that are not usedi Some of the features not available 
when your PG is configured for EM include mainframe 
graphics, printer emulation; notepad windows, copy 
data, screen capture, and help; 

• EMS (Expanded Memory Spedficatibn) lets you reduce 
the amount! of memory thatEXTRA.' uses by storing 
ihfrequently-used program modules in PG memory. 
EMS requires a EIM 4.0^compatible memory adapter, 
such as InteVs Above Bbard, and ani EMS 4.0 Driver. For 
more information about EMS, refer to Ghapter 9 of the 
Setup and Reference Manual. 


Because EXTRA/fulljr supports voice synthesizer products 
from Gomputer Gonversati0n8, Ihc., EXTRA/ is now 
accessible to the visually impaired. Users can hear any 
keystrokes they enter, as wellas any characters thatappear 
on the screen; Touse this feature, EXTRA/must be teamed 
up with voice synthesizer hardware and Verbal Operating 
System software from Gomputer GonversatiOns, Irrc. 



About This Manual 


Who Should 
Read This 
Manual? 


The EXTRA/ Extended User's Manual explains how to use 
EXTRA/ to access the mainframe, how to transfer files to and 
from the mainframe, and how to print mainframe files using 
your PG printer. To learn how to installi and set up EXTRA/, 
refer to the EXTRA/ Extended Setup and Reference Manual 
which is included in your EXTRA/ package. Your 
documentationds complimented by the Informatibni Utility 
Files which provide late-breaking updates to the product. 
These files are explained later in this sectidn of the manual. 


This manual is written for newcomers to EXTRA/ and micro- 
to-mainframe communications. To best use the User 's 
Manual, you should be familiar with Personal Computers 
and have a basic understanding of how 3270 terminal 
emulation works. If you are not familiar with 3270 terminal 
emulation) refer to Chapter 1, "Understanding Terminal 
Emulation." 


If you are responsible for installing and customizihg 
EXTRA.Vyou should refer to the Setup and Reference Manual. 


GENERAli USERS 

TECHNICAL USERS 


r .. 1 

r 

USER'SMANUMl 

SETUP AND REFERENCE 





□ 


Ui 


03 




r !i 

Uil 


□ 

□ 


Manual 

Standards 


^ 1 , 


J Important 
Information can b® found 
next to the note Icon that 
appears In ttie outetde 
margin, as shown here. 




Throughout this manual) user input is presented in italicized 
type. Keystrokes are presented in bradkets, such as [El], 
Bdow is an^ example of a; user input command. 

copy a;*.* b: [Enter] 

Menu prompts appear in quotes, for example, "Is the 
Destination a Fixed Disk Drive? (y or N):" 


Mouse and Keyboard Instructions 

While EXTilA/ can be used with either a mouse or a 
keyboard; there ate some procedures in this manual that are 
specific to either a mouse or a keyboard; Instructions 
that are mouse-specific are identified by a mouse icon, as 
shown here. Likewise, instructions that are keyboard- 
specific are identified by a keyboard iconi 


Large Keyboards 


If you^ve worked with mainframes in the past, you may be 
using an IBM 122-key keyboard, which is equivalent to a 
3270 terminal keyboard. Keys on this t 5 q>e of keyboard are 
called Workstation Gontrol keys or "PF" keys, and are 
represented in bold type throughout this manual. For 
example, WsCtrlPFie. 
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Defihftidns 


In ihe EXTRA! Extended documenta Hon^ you also will find 
definition boxes defining words thatl p, ,. . . 777” 

may be unfamiliar to you> as shown; group of characters, 
here. Additional terms are defined representing some unit of 
in the documentatidn'is Glossary, information sudi as a name 
located at the back of each manual 


Your Extra! Extended Package 

The following items are included in your EXTRA! Extended 

package:: 

• EXTRA/Extended Diskettes. 

• The EXTRA/ Extended User 's Manual- This manual is 
aimed at general users who will be using EXTRA/for 
everyday tasks. If you are responsiblfe for setting up 
your EXTRA! software, refer to the Setup and Reference 
Manual described belOw. 

• The EXTRA! Extended Setup and Reference Manual- The 
reference manual is aimed at technical users, such as 
System Administrators, who are responsible for 
installihg and customizing EXTRA/ It provides a 
thorough overview on micro-to-mainframe 
connectivity, and explains how to install! and set up 
EXTRA.Vand how to troubleshoot any problems that 
may arise. 

• The Quick Reference Card - This card provides a 
concise guide to EXTRA/'s commands and keystrokes. 


• Keyboard Templates - EXTRA! supports all major 
terminal keyboards. These templates show you how to 
use your PG keyboard in the same ways that you would 
use a 3270 terminal keyboard. Together, the templates 
and your PG keyboard allbw you to smoothly carry out 
mainframe commands. 

• Product Support Registration! Gard - By completing this 
card and returning it to Attachmate, you become 
enrolled in Attachmate's Gustomer Support program. It 
also allbws us to keep you abreast of any changes that 
occur to the product. 

• Documentatibn Feedback Gard - Attachmate is 
committed to providing high^quahty documentation for 
its products. To achieve this goal, we need your ideas 
on! how we can improve our documentation By filling 
out this card, you can provide us with this inputs 
allowing us to add your suggestions to future editions 
of the documentatibn. 


For More Information 

Most ofi the infoi^mation you need to set up and use EXTRA/ 
can be found in either this manual’or the EXTRA/ Extended 
Setup and Reference Manual There are, however, other 
sources of information which you may find helpful: You can 
access the HELP program.by pressing [Ctrl/Alt] [H] from 
within EXTRA /, or refer to the Quick Reference Card. 


To obtain! late*breaking information about the current 
release of EXTRA/, you'can*read the EXTRA/ INFO files, 
which are explained in the next section; If you stilll can't find 
the infoimation that^ you need, feel free to calf Attachmate's 
Technical: Support department at 1^800^888-1187. 

At the end of this introduction, we Ve included a list of 
additional reading materials thatyoumay find helpful. 
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The INFO 
File 


xviii 


An Information Utility File is provided on the EXTRA! 
ProgramiDiskette. The INFO File contains information' 
about updates to EXTRA / that are not included in; the 
manuals. 


Viewing the INFO File 

To view the INFO'file, type at the DOS prompt: 
info [Enter] 

If using a Floppy Disk System) make sure that the EXTRA/ 
Program Diskette is in the default drive before typing info.. If 
using a Fixed Disk System, make sure that the files on the 
EXTRA! Program Diskette have been copied into your 
current subdirectory before typing info. 

To select a specific INFO file topic, simply position the 
cursor next to the desired topic and press [Enter]; The 
Utility will display the selected file one page ata time; Use 
the [PgDn] and [Home] keys to page through the file. 
Pressing [Esc] returns you to the Info Utility's Main.Menu'or 
to the DOS prompt. 


Printing the INFO Filfe 


You can obtain a printed copy of the file page being 
displayed by pressing [Shift] [PrtSc]. 

If you would like to have a printed copy of an entire INFO 
file, follow these steps: 

1 From' the Information Utility's Main Menu, note the 
name of the INFO file that you would like to print. 

2 Exit the Information Utility by pressing [Esc], 
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At the DOS prompt^ type the following: 
copy kfilename.inf Iptl: [Enter] ^ 

-OR^ 

print bfilename.inf [Enter] 

Where b is the letter of the drive containing the INFO 
file^ filename is the name of the INFO file displayed in 
the Information Utility's directory, and Ipfl; represents 
the port for which the printer is configured. On some 
systems it may be necessary to substitute /pf2;, coml:, or 
com2; for Iptl:. 



Additional 

Reading 


The following publications can help you leam more about 

the operation of your personal computer, 3270 emtdatibn, 

and host communicationi peripherals. 

• IBM 3270 Information Display System 3274 Control 
Unit Description and Programmer's Guide. IBM 
Publication GA23-0061. 

• IBM 3270-InfQrmation Display System Data Stream 
Programmer’s Reference. IBM Publication GA23-0059. 

• 3278 Display Station Operator's Guide. IBM Publication 
GA27-2890. 


• IBM 3287 Printer Operator's Guide. IBM Publication 
GA27-3230-1. 

• IBM PC Guide to Operations, IBM Publication 6025000. 

• DOS 3.3 Disk Operating System Reference. IBM 
Publication; 

• IBM 3270 Personal Computer Control Pfogrami Guide, 
IBM Publication SA23-0221. 

• IBM HLLAPI Programming Guide (59 x 99591. 

• Programmer's Toolkit Reference Manual; Volumes I 
and II, Attachmate Publication. 




1 Understanding 
Terminal Emulation 

This chapter explains the basic concepts behind 3270 
terminal emulationi By reading this chapter, youlll learn 
what terminal emulation means, and what is required in 
order for terminaliemulatibn to occur. You'll also learn 
about sessions, windows, layouts, and multiple sessions. 
Learning about these concepts willhelp you to successfully 
use EXTRA/ to access the mainframe, transfer files, and print 
mainframe data. 

If you already have a good understanding of this 
information) feel free to skip to Chapter 2,"Using EXTRA! 
Extended"' 
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Discussion: What is Terminal Emulation? 


Basically, 3270 terminal emuktibniallbws your PG to act like 
an IBM 3270'terminal. The PG can exchange information 
with; the mainframe, just like a 3270 terminal 

The 3270is the predominant terminal used to access IBM 
mainframe computers. Introduced by IBM in 1972, it has 
become the industry standard, even with nomlBM vendors. 
In the past few years, it's become quite popular to emulate 
these devices on a PG through the use of hardware and 
software, such as Attachmate's EXTRA! Extended, 

PGs have become more popular because they are more 
versatile tham terminals. While many terminals are 
inexpensive,,they are limited in function since they rely on 
the mainframe for processing. A PG performihg terminal 
emulation, however, adds a new dimension! to data 
processing by combining the muscle of a mainframe with the 
local processing ability of a PG. For example, a retail store 
can use a PG in "stand-alone mode" to record sales 
transactions and to produce weekly sales and inventory 
reports. The same PG could thenibe used in "terminal 
emulation" mode to access the company's mainframe 
database for pricing and inventory information) and for 
uploading weekly reports to the mainframe. With terminal 
emulation) you get access to the mainframe's programs and 
databases,,m addition to the local computing power of a PG. 



The 3270 System 


1-4 


The termi "3270'' actually refers to a family of products that 
fall into three basic categories: Display terminals, printers 
and control units. These components, which are discussed 
below, make up the 3270 system; With EXTK^/, your PG 
can emulate the display terminals in this system> giving your 
PG access to mainframe applications and data. And your 
PG's printer can emulate mainframe printei:s, allowing you 
to print mainframe files directly off the mainfoame. 



Display Terminal Printer Display Terminal 






Display 

Terminals 


Printers 


Display terminals connect to a controlimit (described on the 
next page); There are several variations of display terminals 
to accommodate different screen sizes and color 
combinations. In general, 3178 and 3278 terminals offer a 
monochrome display, while 3179 and 3279 terminals offer 
color displays (3178 and 3179 are newer models)., Some 
special models like the 3179-G, the 3192-G, and the 3279-S3G 
also support mainframe graphic images. 

Within each category, different screen sizes are offered. The 
Model 2 offers the same size display as a standard PG, 24 
lines by 80 columns. The Model 3 is 32 by 80;:the Model 4 is 
43 by 80;; and the Model 5 is 27 lines by 132 columns. 


Like display terminals, printers alsoattachito the controller. 
The 3287 printer can accept data directly from the 
mainframe. Qr it can accept data from'the user of a display 
terminal who selects the "Print" or "LocaLCopy" command, 
as long as their terminalis attached to the same control unit. 

Withim the 3287 printer family, models range from those 
with very basic print functions to more sophisticated 
machines that support additional type styles and sizes, 
special margin control, color, graphics, etc. 
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Control 

Units 

The control unit, or controller, connects display terminals 
and printers to the mainframe. The controller is used to 
maximize the efficiency of the link to the mainframe by 
combining and sequencing the messages of multiple devices. 
It can usually control up to 32 terminals or printers that are 
connected by coax cabling. And each device can be up to 
5,000 feet away from the controller. 

The 

Mainframe 

The mainframe contains the applications and databases used 
by your organization, along with a special "Access Method" 
that manages locally-connected controllers. Usually this 
access method is VTAM (Virtual Telecommunications 

Access Method), which manages the entire mainframe 
network. It contains all of the termihali information, as well 
as information about every other device that has access to 
that mainframe. 


Extra! Session Windows and Layouts 


When your PC accesses the mainframe and its applications 
through EXTllA/, it establishes a connection. This 
connection is often referred to as a "session" or "mainframe 
session." If your PC is accessing a PC application/ it is called 
a "PC session" or "DOS session." 


With EXTIM/, your PC can access four different mainframe 
applications and one PC application all at the same time. 
EXTRA/ also lets you access two notepad windows. A 
"notepad" is an electronic scratch pad that lets you create, 
edit and save information for later use. Notepad data can be 
edited, saved, and copied to bo th PC and mainframe 
sessions. 
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Multiple 

Sessions 


What is a 
Window? 


Multiplte session Ifet you run up to four mainframe sessions 
at the same time, switching between them; with; a few simple 
keystrokes. With; multiple sessions, you; ean perform; 
a variety of tasks at the same time. For example,.you; can 
send a file to the mainframe inione sessibn and review a 
mainframe'-database filte ihi another session; all while you?re 
running an application in your PG session. Withmultiple 
sessions, you don!t need to take a break each time you 
transfer a file. Simply start the file transfer, then jump to 
another session and continue working while the file transfers 

in the backgroimd. 


Once a session has been established, data can; move from 
either PG to mainframe or mainframe to PG. The data then 
can be viewed through a "window" on yoiuj PG screen, 
whichican vary insize from as smallas eight characters to as 
large as your PG screen. With EXTJM.', any combination of 
mainframe and PG session windows can be displayed at the 
same time on the PG scr een; You can adjust the color, size, 
and position of the seven available windows. Larger 
windows, such as a spreadsheet, can be viewed by panning 
and scrolling witil your arrow keys. 



Session Dain can be viewed 0tmugh windows. 




About 

Screen 

Layouts 


As explained in the section above, a window is an area oni 
your PG screemthat lets you "view" part or all of the data 
witiun a mainframe or PG sessions The arrangement of 
windbws on the screen is called the "screeni layout." There 
are ten different Screen Layouts available through EXTRA.^ 
two of which are displayed below. For more information 
about Screen lLayouts, refer to the EXTRA/ Extended Setap 
and Reference Manual. 


rB9--SKSI0Ml—- 

1 

€9-SESSI0H2^- 

1 


^-NOTEPADl^- 

_ncu.Qi;>QOTrMo_ 









fSh-K ..". '■.■.". I| 

12:40 1>'84/9BA 


A screen lUyout wiidt all seven windcnvs open 





IfBi—SKIONl^i* 


tCl-“SlSSI0N2^ 


Dl“SE^IOK3- 


IH^SESSI0N4- 


r^l-PC- 


Quick Help 


lo Display 3270 Session...Press JUHP or Ctrl^Alt-SpacB 

To Quit fernlhal Enuiatlon..,..Press WsCtrl PF16 or CtrlJ^Alt-K 

To y ihdow PC and 3270 Session. .Press i-i or CtrIt^ps Lockit 

To Obtain Hors Ilftfomatitin...*.Press HELP or Ctr,l>^01tm* 


cismimy 


P 


0a 


B1--SESS10H1 R 1 C 1 


12:41 1/04^90 


A screen luyout loilM fom mainframe and one PC window 
open 


What's Ahead? 

Now that you have a basic understanding of how 3270 
emulation workS/ you're ready to begin using EXTRA/ 
Extended^. Turn to Chapter 2, "Using EXTRAl Extended," to 
get started. 


K you would Uke to learn more about 3270 miero-to- 
mainframe connectivity, turn to the first chapter of the 
EXTRA! Extended Setup andReference Manual,. "An Overview 
of 3270 Communications." 
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Extra! Extended 


This chapter explains how to use EXTJM/ Extendedlox 
3270 terminal emuMibn and other tasks. By the time you 
complete this chapter, youll know how to accomplish the 
following: 

• Bring up £XTRi4/'s mainimenu* 

• Establish a session with the mainframe, then "jump" to 
another. 

• Use EXTRA !'s Help program; 

• Capture a screen; 

• Copy data from one session to another. 

• Exit EXTRA/ and return to your PCs DOS prompt 
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Discussion: What You Need To Get Started 


Before youi can use EXTiM/ Extenrferf^you need to make sure 
that youi have anilBM PC or compatible, that it has enough 
memory for EXTRA! (at least 256K), and that EXTiM/;has 
beendnstalled and Gustomized on your PC. If EXTiM/ has 
beeninstalled and set up by your company's System 
Administrator, they need to provide you with the following 
informatibm: 

• Where is the EXTRA! software located? On your hard 
drive or on a floppy diskette? 

• What type of "connection'' does your PC have to the 
mainframe? Coax, Local Area Network (LAN), Token 
Ring (DLC/DPT), or Remote Modem/SDLG? If you 
are connected viaTocal Area Network (LAN) or 
Remote Modem>, the startup screens shown in this 
chapter may look different fromiwhat you see on your 
screen; Appendix A,, "LAN and SDLC Startup 
Conditions," describes these screens. 

• What keyboard template do you need for your 
keyboard? These templates show you where the 3270- 
terminal keys are located on your PC keyboard, so you 
can carry out mainframe commands. 

• Has your System Administrator configured EXTRA/ for 
Low Memory (LM)? LM is very useful when your PC 
has limited memory. When you are configured for LM, 
you have access to EXTRA/'s mosts-commonly used 
features, butyou do nothave access to these features: 
printer emulation, "windowing" PC and mainframe 
sessions, screen capture,, copy diata> notepad windows, 
mainframe graphics, and viewing APL characters. 


If you are the one who is responsible for ihstallihg and 
customizing EXTIM/, refer to your EXTRA! Extended Setup 
and Reference Manual. The Setup and Reference Manual also 
provides detailed information! about types of connections 
and keyboard mapping; 


This chapter begins by explaining how to bring up EXTRA/'s 
first menu. Erom this menu> you are given a quick tour of 
EXTRA/, and shown its basic features. You then willibe 
provided with a more detailed tour. Once you understand 
these features, you'llibe ready to effectively use EXTRA/ 


Bringing Up Extral's Main Menu 

Before you! start using EXTRA/, you should make certain 
that the program has been installed and configureddn your 
PG. You also must know where your software is located, on 
your hard drive or on a floppy diskette. If youlre not sure, 
ask your System Administrator. 



Hard Disk 
Systems 


1 Activate the hard disk subdirectory where your 
EXTEA! files are stored. To activate your EXTliA/ 
subdirectory, type the following after the DOS prompt: 


cd xxxxx [Enter] 


where is the name of the subdirectory that 
contains your EXTRA! files. 


' To tun EXTHAt, 

you may need to type a 
name other than extra 
after the DOS prompt 
since your System 
Administrator can select 
another Startup Name 
during configuraUon. 


2 At the subdirectory's DOS prompt, type: 


extra [Enter] 


Floppy Disk 1 Place your DOS diskette (version'3.0 or later) into 
Systems Drive a then reboot [Gtrl/Alt/Del] the system so that 

the DOS prompt appears. 


2 Once DOS is loaded, remove the DOS diskette from 
Drive A and place the EXTiM/ Program Diskette into 
either Drive A or Bi Make that drive the active drive by 
typing its letter (A or B) and a colon after the DOS 
prompt, and pressing [Enter].. For example, to make A 
the active drive, type the following after the DOS 
prompt:. 


a: [Enter] 


3 


To load EXTRA!, type the following after the DOS 
prompt: 


extra [Enter] 


As the softw:are loadS; your PC will display a screen with: the 
EXTRA! Extended logOi After the logo; you willi see the 
Startup Screen as shown below: 


Hettiork initUllzatibn cowplete 


mm hdeM 
Release ZM 


Co) Copyright Attac]^ Corp. 1983-1990 
Alii Rights Reserved 

Licensed Hateriali - Frogran Property of Attachnate 


---- Help--- 

To Display 3270 Session..Press JUHP or Ctrl/Alt-Space 

To Quit Tcrnlnal Eiiulatlon.....Press ysCtrlPFlS or Ctrl/Alti-K 

To yindow PC and 3270 Session..R«ss i-i or Otrl/Alt-Caps kick* 

To Obtain Hore Infomailon.....Press IffiLP or Ctrl/AllnH* 

* not applicable to the EXTRA!(LH coitf iprations 


timmy 

















A Quick Tour of Extra! 




Before beginning 
any of these exercises, 
fTvake certain that the 
startup PC screen Is 
displayed In full-screen 
mode, as shown on the 
previous page. (prl/AltJ 
ICapsLockJJ 


In this section, you'llbe given a quick tour of EXTRAI ’s basic 
functions. These functions include jumping from one 
session to another, "windowing" both a P€ session and a 
mainframe session at the same time, enlarging a session 
window, jumping into EXTRA.''s Help program* and 
quitting EXTRA.' This exercise will not provide you with 
detailed instructions on how to use the product, but wilt 
give you a "taste" of what the software can: do* Each of these 
functions will’be explained in more thorough detail later on: 
ihithis chapter. 


Jumping This first exercise teaches you how to jump from your PC 

from session to amainframe session and back; 

Session to 

Session T From the main menu, press [Ctrl/AltJ [Spacebar] or 

Jump if you have a large 122-key keyboard. You now 
should be in your mainframe session; This mainframe 
session is acting exactly like a 327G terminal. 

2 To get back to the PC session* press [Ctrl/Alt] 
[Spacebar] or Jump again. 


You’re now ready for the second exercise, "Windowing and 
Enlarging Sessions." 


Windowing 

and 

Eniarging 

Sessions 


Using Heip 


This Gxercise teaches you how to view more than; one session; 
window at the same time, as wellias how to enlarge a session; 
window to fullt-screeni mode. 


T Brom the main menu, press [Ctrl/Alt] [CapsLock] or 
WsCtrr|-|. You now should see both the PC session 
(with its DOS prompt) and a mainframe session at the 
same time. 

2 To enlarge the PC session again> press [Ctrl/Alt] 
[CapsLock] or WsCM |-| once more. 


You're now ready for the third exercise,"Using Help." 


This exercise teaches you how to access EXTRAI's "Quick 
Help" program. For more detailed instructions oni 
how to use the Help program; see "To Obtain More 
Information" later on in this chapter. 


1 From EXTPA/'s main menu, press [Ctrl/Alt] [H] or 
Help if you have a large keyboard. You now should 
see the "Main Htelp Panel" While this screen provides 
you with a crossroad of options, do not select any of 
them except [Esc]. These options are discussed later on 
in the chapter. 

2 To get back to EXTlM.f's main menu, press [Esc].. 


You're now ready for the last exercise, "Quitting Extra!" 



Quitting 

Extra! 


This exercise teaches you how to exit EXTIM/ from inside 
either a PG session or a mainframe sessiom This command 
removes EXT2?i4/ from your PC's memory, and returns youi 
to the DOS prompt. 

1 From the main menu> press [Ctrl/Alt] [K] or WsCtrl' 
PF16 if you have a large keyboard. 

2 The follbwing prompt will appear at the bottom of the 
screen: "Do you wishi to remove the terminal emulator? 
Enter Y or N." Type [Y]. You now should be at your 
PC's DOS prompt, 

3 To reload EXTRA.', type extra after the DOS prompt and 
press [Enter]. 

You: now are ready to learn more detailed information: about 
each of these functions. 


The Grand Tour of Extra! 


This section explores in i more detail eachi of the options that 
appear on EXTRAI's main menu; shown below. 




EXIHA! Bxtenaea 
leioasa 2.60 


(d) Copyright Attadiiaife (brp. iS83-1990 
Alii Rights Seservei 
Licensed HaterlaL ^ Frogran Property of Attadniate 


p——---Qalok Help _1 




To Quit TerniimlEnulkilon..,, 
To UiMou PC and 3270 Session. 
To Obtain More Infornatldn.... 

* not applicable to ite EXTMt 

.Press UsCt 
.Press i-i 
.Press HELP 

IM confipr 

ri PF16 or Ctrl/Alt^K 

or Ctrl/A li^Caps Lock** 
or Ctrl/Alt-H» 

atIons 


ismim 






To Display a As explained in the "Quick Tour of Extra!,!' you can jump 
3270 betweeni the PG session and the first mainframe session by 

Session pressing [Gtrl/Alt] [Spacebar] or Jumpi This same 

command also lets you jump to the second, third, and fourth 
mainframe sessions. 


J This feature is not 
availableIf you are 
configured for EXTRAl's 
Low Memory, (LM) option. 


The screen layout 
numbers given In this 
chapter referto the default 
layouts that Initially come 
with the product. Your 
System Administrator may 
have made changes to 
these layouts. For more 
information on screen 
layouts, refer to chapter 6 
of the Setup and 
Reference manual. 


Bfefore attempting to jump to these sessions, make sure that 
your screen layout allows you to access these sessions. (If 
you cannot access more than one session) try selecting 
Screen Layout li through [Ctrl/AltJ [1].) If you select layout 
1, your PG session and the four mainfirame sessions will be 
displayed on the screeni To access each of these sessions, 
press [Gtrl/Alt] [Spacebar] or Jump. Each time you^ select 
these keystrokes, you will! advance to the next session in the 
sequence until you return to the PG session. 


EXTRA! gives each of these sessions a default: short name 
and long name, which are shown in the table below. You 
may want to check with your System Administrator to see if 
these default names were changed during EXTRA!'s set-up 
process, and how many sessions your system^ is configured 
for. 



Default 

Default 

Session Type 

Short Name 

Long Name 

PG Session 

A 

PG 

Host Session 

B 

SESSION! 

Host Session. 

G 

SESSION2 

Host Session 

D 

SESSIONS 

Host Session 

E 

SESSION! 

Notepad Session 

F 

NOTEPAD! 

Notepad Session. 

G 

NOTEPAD2 


The Jump Command 

While the [Ctrl/ Alt] [Spacebar] command works well for 
accessing sessions A or By it can be time consuming when 
accessing other sessions. EXTRA! therefore provides a 
shortcut for accessing sessions, letting you jump directly to a 
specific session! This command is shown below: 

[Ctrl/ Alt] [J] [n] or WsCttl n 

where M represents the short name of the session you 
want to access (A through 6). 

With this command, you can jump to any session window. 
You can verify that you have jumped to the right session 
window by looking at the window's border, which displays 
its short and long name in:the top left corner. The'window's 
short and long name will not appear if it is ih fuUi-screen or 
"enlarged" mode. To return the window to "windowed" 
mode, press [Ctrl/ Alt] [CapsLock]. 

The Operator Information Area (OIA), located at the bottom: 
of your screen* also displays the session window's short and 
long name, along with other session information. The OIA is 
discussed in more detail in the next section. 


The Operator Information Area 


The Operator information Area (OIA) provides you with 
important information about the status of your mainframe 
session and the application that is running in it. This 
information includes the short and long name of your 
session, system: messages, the location of your cursor, the 
status of your printer, etc. 




The OM is located on the last line of your screen; as shown- 
below, and is modeled after the OIA that appears on all: 3270 
terminals. 


MlRfUAL HACHINE/SYSIEH PRODUCl 


Him HHHim n hm X MXXXttXtC X -hx-h 

XKKXX MX Him XXKXX |||tX hhMXK XK M'XXX xkxkmm 

'X'M'IIMM'X 'W'X'X'X Jf'MXXM MM MMM'M'II'X MMX MM MMMMM 


Viriuali HachiDe / Integrated Systen 


Filli in ycur USERIB and PAS^RB and press ENfER 
(Vour passitord uill not appear uhen you type it)) 

USERIB ===> 

PASSyORB ===>; 


COHMAND ===> 


m 


Aa 


mmm vk/is 


Ce-S£SSIQH 1 R 20 C 16 8 -nn 12:17 1 / 84/981 


4B represents Readiness. This message tellte you if you have 
successfully connected to the mainframe; 

Aa represents the Case Mode. This message tells you if 
you^re in upper case, lower case; or upper/lower case. 

G represents the Window Short Name, explained above. 

Oirepresents the Window EayoutNumber. This message 
tells you what screen layout number was selected. (Screen 
Layouts are explained ini "To Window PC and 3270 
Sessions.") 

SESSION! represents the Window Long Name, as 
explained above. 



R 20iC 16'represents the Cursor Location, This message tells 

you the Gurrenti row and columni location ofi the cursor 

within the window. 

0*nni represents the Printer Status. This message tells you 
the current status of your 3270 printing operation. (See 
Chapter 3 for more information! about* printing.) 

12:17 represents the current Time, in 24.hour time; 

1/04/90 represents the current! Date. 

L represents the Scroll Lock Status. To toggle or switch 
between! Scroll Lock on and Scrolli Lock off, press [Ctrl] / [Alt] 



Turning a Session ON and OFF 


UIMIML HACHINE/^VSm PRODUCI 

«ilil IHHHIlHf «« If IHflHHIlHf H 



mm mmmm « « « m k w k m mm 

mm ** 

***** 

mmm mtm m m mt mtmt mm* 

*mm MKKiittKMM 

M'll'iUl'il' iWt IHHt MmiMlf MMit 

WHfiHHf 

mmmm 

watiiMif mm* ***** m ****** 

ffim ** 

***** 

WHHHHW MHHH, » WHHHH. 


****** 

Hadiine / Iht^pated Systan 


Fill in gwr USERID and and press ENTER 

(Vomr password will not appear when you type It) 



USERID ===> 

MSSyORD ===> 



COHMAND ===>> 


RUNHIHe mw 





If the OIA in your session! window displays the message 
"3270 TERMINAL OFF," iti means that your mainframe 
session has not been turned on^ and is not communicating 
with the mainframe. To turn the session ON, jump to its 
window and press the keystrokes shown below; 


[Ctrl/ Alt] [O] or WsCtrl Reset 


/ If you sore using a 
LAN,connection, sessions 
are turned on and off 
indivlduatiy, If you are 
any other type of 
connection, the session 
ON/OFF command will 
turn all mainframe 
sessions on or off. 


The 3270 TERMINAL OFF message wiUi disappear after 
selecting these keys. These same keystrokes also will turn a 
session OFF, which ends communication between the 
session and the mainframe. Your System Administrator can 
customize EXTRAso that all terminal sessions will be 
turned GN or OFF at startup. The default option is "ON" at 
startup. 


If you have questions about the OIA and its messages, refer 
to Chapter 7 of the EXTRA.^ Extended Setup and Reference 
Manual or contact your Systemi Administrator. 
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To Window 
PC and 3270 
Sessions 


--—-Quick Help ..... 

lo Jlsplas ^ ^Sion-Press JUMP or Ctrl/ftlt-Space 

To Tasiinal KMMlatlon-Press UsCtrl PP16 or Ctrl/'fllt-M 


To Obtain Hope Itifopnatioii,,,..Press HELP 
not applicable to tbe EXTRAt LH conf ijupations 


01* Ctrl/Alt-H« 


The virtndowing 
feature Is not available If 
you are configured for 
F ■fl4/'s Low Memory 
(LM) option. 


Once you know how to jump to session windows and 
determine their status through the OIA, you!re ready to 
learn some of the more advanced "windowing" commands. 
These commands wilflet you display several windows on; 
your screen at the same time, "browse'' around each of the 

windows with your arrow keys, enlarge a window then 
shrink it down; again, and change the case of the characters 
on; the screen; 
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About Sct^eri! Layouts 

As explained in Chapter 1, "Understanding Terminal; 
Emulation^" a window is an area on your PC screen that lets 
you "view" part or allSof the data within a mainframe or PC 
session. The arrangement of windows on the screen is called 
the "screen layout" as shown ins the sample below: 



A semen layoM wMi aWseven windows open 

You can display ten different Screen Layouts using EXTRA! 
Each time you press the keystrokes shown below, the next 
screen layout will! appear on your screen: 

[Ctrl/Alt] [Tab] or WsCtrl ChgSe 


J 

J 
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Each of these Screen Layouts is identified by a number (0 
through 9)> which appears in the OIA. If you would: like to 
display a specific screenilayout, EXriL4/provides a shortcut 
which is showmbelow: 

[Ctrl/Alt] M or WsGtrl x 

where X represents the number of the layout that you would 
like to view (0'^9). 

When viewing a screen layout, you will! notice that one of 
the windows is surrounded by double lines. These lines 
identify the window as the "active session" which contains 
the cursor. For more information!about Screen Layouts, 
refer to the "Designing ScreeniLayouts" chapter of the 
EXTRA! Extended Setup and Reference Manual 


Enlarging a Window 

Any of the windows that appear in the screen! layout can be 
enlarged to fill the entire screeui To enlarge a window, jump 
to the window that wilt be enlarged and select the 
keystrokes shown below: 

[Ctrl:/ Alt] [CapsLock] or WsCtrl H 

To" shrink" the window down to its original i size, use these 
same keystrokes. 



Browsing Through a Window 



This feature Is k©ylK>arel 
specific; you cannot scroll 
down into a "windowed" 
mainframe window vwtti a 
mouse. 


If you would like to view the contents of a window without 
enlarging it, you can use EXTlM/'s browse feature to scroll 
dbwn into the window and browse around. To use the 
browse feature; press the keys shown^belbw:: 


[Ctrl/ Alt] [B] [W] or WsCtrf PF3. 


J These and other 
"windowing" commands 
are provided on the Quick 
Reference Card which Is 
included in your EXTRA! 
package. 


You then can use your keyboard's arrow keys to move 
around in the window. To turn off the Browse feature, press 
the key shown below: 


[Esc] or WsCtrt 


Changing Character! Case and Base Coior 

In addition to letting you enlarge and browse a window, 
EXTRA/ also lets you change the case of all the characters in 
a mainframe window and change the window's base color. 

EXTRA/ presents all mainframe sessibn characters in upper 
and lower case. To change the characters to upper case only, 
press the keys shown below: 

[Ctrl/ Alt] [€] [A] or WsGM Alt/PF24 

These same keystrokes will return your window to upper 
and Ibwer case, and is equivalent to the Aa: case switch on a 
3270 terminal. The OIA displays the currently-selected 
character case. 


If you are using a color PC monitor, EXT]?i4/ also lets you 
change the base color of a mainframe sessibni window by 
pressing the keys shown below: 


[Ctrl/Alt] [Bl [C] or WsCM PF21 


This keystroke sequence is equivalent to the base color 
switch on a 3270 termihali 


Changing the Cursor Style 

With EXTRA/, you also canchange the style of the cursor in 
a mainframe session from the default underline cursor, to a 
blinking block 

To change the cursor, press [Ctrl/Alt] [C] [C]. These same 
keystrokes return youi to the default cursor style. 


Avoiding Window Overwrite 

With EXTRA!, yow can display all of your mainframe, PC, 
and Notepad sessions simultaneously. Each of these 
sessions will operate independently ofi each other, so you can 
enter information into one sessioni while other sessions are 
transferring files and printing mainftame data. 

At times, however, it's not practicalito have alii of your 
session windows operating simultaneously. For example, 
many PC applications, such) as a number of word processing 
and spreadsheet programs, write directly to the PC screen, 
ignoring EXTRA/'s window boundaries. These programs, 
therefore, "overwrite” the screeni EXTRA/ provides two 
ways of avoiding a "window overwrite" situation, 
depending om whether you currently are in the PC window 
or a mainframe window. 



PC Window Method!: If you are running a PG application 
that may overwrite the screen; you: can make sure that other 
windows on your screen layout will! not be overwritten by 
enlarging the PG window before loading your PG 
application. You can enlarge the window by using 
EXTRAI's Enlarge feature: [Gtrl/Alt] [GapsEock] or 
WsCM|-| 

Mainframe Window Method: If you are running a "screem 
overwrite" PG application in your PG session!and you have 
jumped over to a mainframe session; you may not be able to 
view your mainframe session window. In order to view the 
window, you either must unload the overwriting PG 
program: or use EXTRA/'s "Goncurrent-PG" option; 

"GoncurrenbPG" prevents the PG application from! 
interfering with the mainframe window by temporarily 
suspending the PG application. The PG application will not 
run until you jump to the PG window and enlarge it using 
EXTRAI's Enlarge feature. To set EXTRA.^'s "Goncurrent-PG" 
feature to PG Session "OFF," use the command shown below: 


[Gtrl/AltjlU] or WsCtrl Alt/PF22 


[f ypy have a LAN 
comectlon, turning 
"Concurrent-PC" to OFF 
can disconnect your 
workstation 
communication. 


This same command turns "Goncurrent-PG" On. EXTRA! 
automatically sets "Goncurrent-PG" to On; however your 
System! Administrator can change the default to Off through 
EXTRAI's Gustomizatibn program,. You can use 
EXTRAI's Help program to find out if "GoncurrenbPG" is set 
to Oh or Off by pressing [Ctrl/Alt][H] or Help,, then [W]. 
EXTRAI's Help program is explained in more detail in the 
next section. 


To Obtain 
More 

Information 




J This featyr© Is not 
available if you are 
configured for EXTRA!*s 
Low Memory (LM) option. 


----Quick Help, —- - 

fo Display 3270 Session.,*...^,Pres8 JUHP or Ctrl^Alt^-Space 

lo (folt Teimlnal Ei»iuUtifm.,...Rpess feCtrl PF16 or Ctrl/Alt-K 

mZi ^ Session. ,Pi*es8 ■-■_or Ctrl/Alt^Cai^ Lock** 


-Ig-jMMft Infortiation.Press HELP _ or Ctrl/Alt-H* 


not applicable to the EXTfiAt^LH conf igurations 


EXTRA! is equipped with an I online Help program. This 
program provides you with instant help whenever you need 
it. If you’re in a PG session or a mainframe session, you 
always camgetHelp by pressing [Ctrl/Alt][HJ or Help. 


After pressing [Gtrl/ Alt] [H] or Help> the following menu 
will appear:, 


mHA! Mended « 
Mersibn Z.B0 


MAIN HELP PANa ■ 


y Uindow Hanagenent Connands 

f 3270 ferninaliFunction Happing 

P .........--- Printer and Data Transfer Functions 

S .........Saye^kestore Notepads or Screen Prof i let 

K Quit running ETRAt Exit to DOS., 

ESC To Exit Help Henu 


ETER (belection) 


12:16 l/64/98d 












EXTPIA!, 

commands can be carried 
out either from within the 
He^ program (CtrVAIt 
Spacebar for ^mple), or 
from outside Help. 


When the menu appears, decide what category you would 
like to explore, them select the appropriate key. From the 
submenu that may appear, press the key for the function 
that.you want carried out. 


Exiting Help 


You can. exit the HELP program andi return: to your PG or 
mainframe session at any time by pressing: [Esc] or Help. 


To Quit 

Terminal 

Emulation 


r-- Quick Help- 


1 

1 To Display 3270 Sessibn........Press 

JUMP 

or 

Ctrl/Ait-Space | 





To Uiiidou PC and 321% Session..Press 

i-i 

or 

Ctrl/AllHCa]^ Lock** 

To Obtain fiore Inf omation.... .Press 

HELP 

or 

Ctrl/Alt-H» 

not applicable to the EXTRA!: LH configurations 




As explained in the "Quick Tour of Extra!," you can quit 
EXTRA! at any time by pressing the follbwing keys: 


[Ctrl/Alt] [K] orWsetrl PFie 


After selecting these keys, the following prompt will appear 
at the bottom of the screen: "Do you wish: to remove the 
terminal emulator? Enter Y or N." Type [Y]. You now 
should be at your PC's DOS prompt. 




} Before quitting 
EXTfiAJ, be sure to log off 
of all mainframe 
applications. 


This command totally removes your EXTIM/ software from 
your PG*s memory. To reload EXTJM/, type extra after the 
DOS prompt andipress [Enter]. 






Untoadihg Portions of EXTRA! 


If you would like to run a memoiy-intensive PG program 
and EXrRi4/, but have found that your PC does not have 
enough memory to support both programs, you may want 
to use EXTRAI's UNLOAD feature. The UNLOAD feature 
lets you'imlbad all but the most^essential program files that 
make up your EXTRA! Extended soitware. Unloading these 
nomessential files willl provide your PC with additional 
memory. 

For more information oni the UNLOAD feature and 
"unloading" nomessential files, refer to Chapter 9 of the 
EXTRA! Extended Setup and Reference Manual, "Memory 
Saving Options and Features." 


Extral's Additional Features 

Now that each of the options that appear on EXTRAt's main 
menu have been explained, you may want to learn about 
EXTRA/'s supplemental features. These features include the 
following: EXTRAt's Notepad Windows, which provide two 
"notepads" for writing text with a line editor; EXTRAt's 
Screen Capture feature, which lets you take a "snapshot" 
picture of a session window and save or print the snapshot; 
and EXTRAt's Copy Data feature, which lets you move 
information around within a window or move it from one 
session! window to another. These features are explained in 
more detail in this section. 




Notepad In addition to the four mainframe windows and the PG 

Wi nd OWS window, EXTRA! also provides two notepad windows. 

These windows can be viewed, as shown below, by pressing 
the following keys:: 

Ttiis feature is not 
available if you are 
configured for EXTRAVs 

Low Memory (LM) option. [Ctrl / Alt] [9] Or WsCM 9 


rB9--SESSI0Nl-- 

i 

^9--SESSI0H2-- 

i 

1 

1 

j 


|f9-N0IEPABl^- 

_nQ—OTTCTftMQ_ 



i 





A9—PC= 

oismmy 


izm tmmM 


The notepads have fulbscreen line editors thatlet you write 
a one-page note (up to twenty-four, SO-character lines in 
length).. To begin writing on your "notepad,” jump to one of 
your notepad windows and start typing, using the editing 
commands shown on the following page. After you are 
finished writing, you can save the page as a disk file, and 
reload the file at a later time. 















You can edit the text in your notepad windows using the 
following commands: 

Edit Keys Function 


[Home]! 

Moves cursor "home'' (row 1> column 1). 

[End] 

Moves cursor to the end of the "page" 
(row 24, column 80); 

[Arrow] 

Moves cursor one character space, in 
any direction. 

[Del] 

Deletes character ati cursor. 

[Ins] 

This key "toggles" between Insert Mode 
and: Overwrite Mode; In Insert, it lets 
you add characters. In Overwrite, it lets 
you type over existing characters. 


[Backspace] Backspaces and deletes character. 

IF2] Clears screen and brings cursor "home." 


Jumps cursor to a new line. 



Saving and 
Retrieving 
Notepad 
Files 


To save the contents of your notepad window to a disk file, 
or retrieve the file from a disk, use EXmA/'s Save/Restore 

Notepad feature by pressing the following keys: 

[Ctrl/Alt][X][N] or WsGtfl PF6 

You then will be asked if youfd like to save the window [S] 
or retrieve a notepad window file [R] from your diskette. 
Press [Sj if you are saving a file, or [RJ if you are loading a 
file. 


EXTRA! will ask you to specify a filename; as shown in the 
menu below. 


Save/Bestore flotepads FUe =: 


■* PC Filenane 
selection fomat' is: 

[d:] (path] Mlenane (vext)j 

ENIEF (fiienane): (ret) 

> 




J Although you can 
add Notepad information 
to the end of an existing 
file (Continue option), only 
the first 1920 characters of 
the fife can be dlsptayjSd in 
the Notepad window. 


Type a filename after the prompt, with its disk drive and file 
extension (optional),,then press [Enter]. Your notepad 
window will be saved if you selected [S], or it willbe 
restored to your window, if you selected [R]. 



Screen 

Capture 


J This feature is not 
available if you are 
configured for EXTRArs 
Low Memory (LM) option. 


EXTRAI's Screen! Capture feature lets you take a "snapshot" 
picture ofi a text window sessiom The snapshot then can be 
saved as a disk filb or printed on your PC printer. With 
Screen Capture, you can even save the contents of several 
windows into one file. 


To capture a non-text image, such as a graphic, use 
EXTRAI's graphic option program, Host Graphics Option. 
You cannot capture a graphic image with EXTRA/'s Screen 
Capture feature. 


Screen Capture also provides a one-time options This option 
captures the contents of one screen, then automatically turns 
off screen capture. 




J The contents of a 
notepad window cannot be 
saved with Screen 
Capture. Follow the 
Instructions for Saving and 
Retrieving Notepad Flies. 


To begin using the Screen Capture feature, jump to the 
session window thatyou wantto capture, be it a mainframe 
window or your PC window. Once you are at the window 
you want to capture, press the keys shown below: 


[Ctrl/Alt][S][G] or WsCtrl PF17 


The following menu will appear at the bottom of your 
screen: 


' --- Screen CaiiurB =| 

Capture Screen kta to:: I 


^ P1 __PC Printer Ifli 

D ... PC Disk 

E End Screen Capture 

(Precdle choice with 0 If one-tine capture desired) 

EN!ER (device selection) 12!^ 1/84/98 








Saving The Screen 


1 If you would like to capture a window and save it to a 
disk, select [ID] from the menu; This command will add 
a prompt to the menu: shown below. If you only plan; to 
capture one image (one*time capture), precede your 
selection with an [O], 


. Screen Capture =j 

Capture Screen Data to! 

PI PC Printer LFM 

D ....PC Disk 

E ............... End Screen Capture 


* PC Filenawe 
selection lornat is!: 

[d:i [path] fllenane (:.ext); 

ENfER (f 1 lenane<ret> 

> 


2 The menu will! ask for a disk drive, filename and 

extension; (The drive and* extension: are optional.) For 
example; assume you would like to save the text from 
windbws A, B> and G into an a: drive file named 
"sales3;txt" In this case, you would!type the follbwing 
file name "a:sales3;txt" and press [Enter].. 







3 Press (unshifted) [PrtSc] to capture the information 
using a standard keyboard; press (unshifted) [Print] to 
capture the information using a 122-key keyboard. If 
you are using an Enhanced Keyboard, press [Alt] [Scroll 
Lock]. 


You also can capture the contents of severali windows. 
For example, jump to window A and press [PrtSc]. 
Then jump to window B; and press [PrtSc] again. Each 
time you press [PrtSc], you'll notice the light on your 
disk drive flashing to indicate the image is being 
capturedi Finally jump to window G and press [PrtSc] 
againi 


If you do not press 
prt/AllElIClorWsCtrl 


PF19 to end Screen 
Capture and close the 
current file, the text will not 
be captured. The text also 
may be added to a 
previously-^SBved screen 
capture file. 


4 


Once the desired text has beeni captured, youi will! need 
to close the file. Press [Gtrl/Alt][E][G] or WsGtrl PF19' 
to dose the file. To save text to another file, reactivate 
the Screeu Capture Menu with [Ctrl/ Alt] [S][C] or 
WsetrlFF17. 


Displaying A Saved Screen 

1 To display the window thatyou have saved using 
Screen Capture, simply jump to the PC window and 
use the DOS "type" command to display the screen 
capture file. For emmpleitype a:sales3.txl 


Printing The Screen 

1 If you would like to print a copy of your session 
window, select [P] from the Screen Capture menu. If 
one-time capture is desired> precede your selection with 
an [O]. 

2 Each time thatyou press [PrtSc], the textonithe screen 
will be directed to the PC printer on portLPTl. 



3 To end Screen Capture, use the "End" functibn by 
pressing the following keys: 

[Ctrl/Alt][E][G] or WsCM PF19' 

Or^ you can select optibni "E" off the Screen; 

Capture menui 

Whenever Screen Capture is turned on ([Ctrl/ Alt] [S] [C] or 
WsGtrl PF17), pressing the [PrtSc] key causes window data 
to be sent to your printer or disk file, as you; have 
designated! 


Copy Data 




J This feature Is not 
available if you are 
configured for EXTRMs 
Low Memory , (LM) option. 


EXTEjAI's Copy Data feature lets you copy blocks of 
information from one session window to another. For 
example, you; could use this feature to copy sales 
figures from a mainframe database to a sales report that 
you?re writing in another window. Before the information 
can be moved; however, it must be tagged or identified as 
"movable." A destination or target window also must be 
specified. 


Copy Data providies you with; two methods of copying data 
from one windbw to another: 


• Method #1: You can tag the information tb be copied 
first, then specify either a PC, notepad, or mainframe 
window as the destinationi 


• Method #2: You cans specify your destihatibni first, ,then 

jump to the window containing the data to be copied, 
where you' initiate the command. (This second: method: 
can only be used if the destination is a mainframe or 
notepad window. The destination cannot be a PG 
window.) 

Each ofithese methods is explained in more detail: on the 

next few pages., 

Method #1: Tagging the Source Wiindow Before Copying 

To specify what area you would like to move;,follOw these 

steps:: 

1 Jump to the window that contains the textwhich you 
wish to copy. Press [Ctrl/Alt] [G][D] or WsCtrl Copy to 
begin using EXTRA/'s Copy Data feature. The 
following prompt will appear: "COPY: select as 
[Sjource/ [Tjarget or Jump (A-Z), [Esc] - Quit." 

2 Type [S] or PF13 to identify the window containing the 
text to be copied (the source window). 

3 Position the cursor at the beginning of the block to be 
copied and press [M] or CrSeli Themarked character 
will be highlighted; Now move the cursor to the end of 
the block of text to be copied; Press [M] or CrSelto 
mark the end of the block. Youfll: notice the entire block 
is now highlighted^ 

4 The following prompt will appear: "SOURCE DEFINED 
[J]ump (A-Z) and select [Tlarget/* Jump to the window 
where you want to move the block of highlighted: text. 


If you are copying to a mainframe window, refer to the 
first section below for further instructions, tt you are 
copying to a PC window, refer to the second: section; 



Copying to a Mainframe Window 

1 If you are not already there, jump to the mamframe 
window where you want to move the block of 
highlighted tfext. To tag the window as your 
destination, t5T5e [T] for target or PF14; 

2 Move the cursor to where you want the text to begin 
and type [M] or CrSeli You wilf see the following 
prompt: "Source and Target Defined) 

[€]-Gopy, [ESejrQuiti" 

3 Select [C] for Copy. Any text that does not fit withini 
the defined window area willbe lost. 


Copying to a PC Window 

1 If you are notalready there, jump to the PC window 
where you want to send a copy of the highlighted text. 
To tag the window as your destination) type [T] for 
target or PF14. 

2 Youiwill see the following prompt: "SOURCE and 
TARCET defined) [Gjrcopy, [tjl-auto <CRi>, [ESC] to 
quiti." Type [L]. 

3 This selection) advances you to the following prompt: 
"COPY with Auto <CR> by [Fjield <GR> or [t]ine 
<CR>." 


4 T 3 ^e [Ljiif you wanttoplacea 
carriage return at the end of 
each copied line. Type [F] if 
you want a carriage return) tO; 
be placed after each) field. 


5 When the textis copied, it wilUbe placed in)the PC 

window. 


Field. A field is a related 

group of characters, 
representing some unit of 
inprmation stick as a name 
or address etc. 



Method #2: Tagging the Destination i Window Before 

Copying 

1 Press [Ctrl/Alt][C][P] or WsCM'Copy tobegih using 
Copy Data. The following prompt will! appear; "COPY; 
[SJource/[T]arget or [J]ump (A-Z)." 

2 If you are not already there; jump to the mainframe 
window where you want to move the block of 
highlijghted text. To tag the window as your 
destination; type [T] for target or PF14. 

3 Position the cursor at the beginning (the upper left 
comer) of the target block and press [M] or GrSeli The 
marked character will be highlightedl Now move the 
cursor to the end of the target block (the lower right 
corner) andi press [M] or CrSel to mark the end. YoutUi 
notice the entire target block is now highlighted. 

4 The following prompt willi appear; "TARCET DEFINED 
[JJump (A-Z) and select [SJource." 

Jump to the window that contains the text you want to 
copy. Type [S] or PF13 to identify the window as the 
source window. 

5 Position'the cursor atthe beginning of the block to be 
copiedi and press [M] orCrSeh Press [C]i or WsCtrl 
Enter to copy the textfrom the source window to the 
target window. 
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Copy Data Notes 

• Before using EXTRA/'s Copy Data feature, yoU’should 
consider how an applicationi running in a destinationi 
window willi treat the incoming data. This 
consideration applies to either of the two Copy Data 
methods. For example, when copying data into the PC 
window running Lotus 123®, the data willbe placed on 
the edit line, even though you place the cursor 
elsewhere om the screem 

• Similarly, when copying to the mainframe window, be 
aware that Copy Data willimove the copied* data to 
wherever you place the cursor. If the cursor is placed* in 
a "protected field," the data being copied will be lost. 


Displaying 
and Printing 
APL 

Characters 


APL (A Programming Language) is a generalipurpose 
programming language that is used by programmers to 
develop problem* solving and data analysis applications. To 
display APL characters in a mainframe window, make sure 
that you are notconflgured for EXTRA/'s Low Memory (LM) 
option and that EXTRA/ has been configured for APL. You* 
then mustputthe session window into "graphics mode" by 
pressing [Ctrl/Alt] [G]; Next, press [Alt/Backspace] to 
display the characters. 


Printing APL Characters 


.^ipRINTQEXEcan 

only b® used with the 
following graphics printers: 
IBM Color Jetprlnter (IBM' 
3852 Model 2) or IBM 
Graphics Printer. 


To capture and print files containing APE characters, follow 
the instructions below: 


1 Type CAPTURE after your PG window's DOS 
prompt and press [Enter]. 


2 FoUowing the instructions provided on page 2-28> use 
EXTRAl's Screen Capture feature to save the APE file to 
disk. 


3 Once the file containing your APE characters has been 
saved, return to your PC window's DOS prompt and 
type PRINTG [Enter]. After selecting a printer,,your 
APE file should begin to print. 


For more information about A Programming Eanguage 
(APE), refer to your APE documentation. 



3 Printing 


This chapter explains how to use EXTRA/ Ex/ended to print 
mainframe or PC files on your PC or shared-EAN printer. 
EXTRA! accomplishes this through Printer Emulation: a 
feature that allhws your PC printer to act just like a 3287 
mainframe printer. 

Chances are the distance from your desk to your PC printer 
is a lot shorter than the distance to your mainframe printer. 
With Printer Emulation* you can use the time you once spent 
running back and forth to the mainframe printer for more 
important tasks. 

This chapter begins with an overview that explains the 
basics of Printer Emulation: It then explains what you need 
to know before getting started, how to use EXTRA/’s Printer 
Emulation feature, and how to check on and end your print 


L 
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Discussion: What is Printer Emulation? 




J TWs feature Is not 
available if you are 
cortfigured for EXTRAVs 
Ijow Memory (LM) option. 


Printer Emulatiom allows a PG printer to emulate or act like a 
mainframe printer. With EXTJM/^ mainframe files and data 
can be sent to a local PC printer, which saves the time, 
expense and inconvenience of using a mainframe printer. 
EXTRA ! supports a wide range of PG printers, including 
Ibw-CGSt printers for simple output or high-quality laser 
printers for more complicated output. EXTRA! also 
supports shared printers, such as those that are used on a 
Local Area Network (LAN). 


£XTiM/'s Printer Emulation feature also lets you print to 
disk, allbwing a mainframe print job to be saved to a PG 
disk. The data then can be used ini other PG applications or 
printed when your PG is not ondine to the mainframe, 
reducing mainframe connection costs. And Printer 
Emulation perfectly compliments the use of multiple 
sessions, allowing you to continue working in a PG or 
mainframe session while another session uses printer 
emulation to print mainframe files. 


Wheniyou use Printer Emulation) itwill reside in one of 
your mainframe sessions, turning it into a "printer session." 
There are two basic types of printer sessions: 


Logical Unit Type 3t This type of printer session lets you 
printmainframe files, but only supports basic formatting 
commands such as the following: upper and lower case 
characters, carriage returns, line feeds, and form feeds. 


Logical Unit Type 1; This type of printer session is the more 
flexible of the two since it supports more^complex 
formatting commands such as tabs, margins, underlining^ 
bold, italics, etc. The preferred type of printer session is 
LUl, not only because it is more flexible, but because it uses 
less mainframe formatting time than an LU3 session. If you 
are using a Postscript printer, such as the Apple LaserWriter, 
your printer session must be configured for LUl. 

Now that you know the basics of Printer Emulation, you're 
ready to get started. 


What You Need To Get Started 


Before you cambegin using EXTRA.' for Ptinter Emulation^ 
you need to make sure that EXTRA / has been customized for 
Printer Emulatibni If EXTRA/ has been installed and 
customized by your System Administrator, he or she needs 
to provide you withi the follbwing infonnationi 


• Which of the four mainframe sessions has been set 
aside to perform Printer Emulation? This session must 
be changed from a "terminal" to a "printer" throughi 
EXTRA!’s Gustomization program; 

• Whattype of printer session do you have, ani LUl or an' 
LU3? This information is needed in order to check oni 
the status of your print job; The printer session type is 
selected' through EXTRA.''s Customizationprogram; 
which is described ini Chapter 3 of the Setup and 
Reference manual. If you are using a Postscript printer, 
such as the Apple LaserWriter, your printer session 
mustbe configured for LUl. (LUl is not available if 
you are configured for GUT mode.): 


• Has the printer session been customized for your 
printer and routed to your printer's location? 

• Is the file that you would like to print residing in one of 
your mainframe session windows? 


• Are you: configured for EXTiM/ 's Low Memory (LM) 

option/ or is your connection to the mainframe using 
DFT/NonrSNA protocol? Printer Emulation is not 
available if you are configured for either of these. 

Once you have the answers to these questions, you'll be 
ready to use EXTRA.l for Printer Emulation If you are the 
one who is responsible for customizing EXTRA.' for Printer 
Emulation, refer to your EXTRA! Extended Setup and 
Reference Manual for instructions. 


Using Printer Emulation 

To the mainframe, your printer session looks just like a 
mainframe printer. The printer can appear to be either "off" 
or "on!‘ to the mainframe. If the OIA at the bottom of your 
printer session displays the "READY" message, as shown in 
step 2 below, the printer session is turned on. If the OIA 
displays an"QFFLINE" message, the printer session is 
turned off. The steps below explain how to turn the printer 
session on, and how to get started using EXTRA/'s printer 
emulation feature. 

1 From EXTRA .''s main menu, jump to the session that 
has been set aside for printer emulation. 

2 The OIA at the bottom of your screen will display either 
of these two messages: 

4Bm 3287 PRINTER EMULATION-READY TIME DATE 
4B? 3287 PRINTER EMULATION-OFFLINE TIME DATE 


3 After either of these messages appear^ press the 
follbwing keys: 

[Gtrl/Alt][P][E] or WsGM PF18 


The following menu^ will appear: 


QIIER 


' 3270 Mnteif EMulatibn ==ii 


♦ Device to copy 
3270 printeip data 
selections are:: 

PI ---- . PCft-inter IPIl 

D ...PC Disk 

S ...End Printer Ewulatibn 

(Precede ohbice Mitk S if P08ISCRIP1 output is desired)' 

(device selection) 12:42 1/04/90 


4 At this point, you need to specify where you would like 
to send your file: to a Printer or Disk. By sending the 
file to your printer, you can quickly receive a hard copy 
of your mainframe file. By sending the file to disk, you 
are not spending as much time on-lihe to the 
mainframe. This option lets you retrieve the file at a 
Ihter time in your PG session to edit and print off-line 
using the DOS print command. 

Once you have determined a destination for your file, 
t 3 q)e either [P] or [DJ and press [Enter]., (If you are 
sending your file to a Postscript printer, press [S]/[P] 
[Enter].) 







5 Ifiyou typed [E)] after the prompt, the following prompt 
will be added to the menu> as shown below. 


= 3270 Printer Enulation =| 

Device to eopy 
3270 printer data 
selections are! 

PI PC Printer LPIl 

D ...PC Disk 

E ....... End Printer Enulation 


■* PC Filtnane 
selection fomat is: 
ld;l [path] filenane (.ext): 

EHTEK (filenaie) <ret> 

> 


Provide a filename as shown below (with its drive and 
file extension, if necessary); 


C: filename (.ext) [Enter] 


6 Once you have specified a destination, jump to the 
active mainframe window that contains the file you 
would like to print. 

7 At the active window, type the mainframe application's 
"PRINT" command. For example; 


J These commancis 
are examples of typical 
mainframe print 
commands. They may not 
be the actual commands 
that you should use. Refer 
to your mainframe 
application's 
documentation for the 
exact print commands. 


spool prt rscsvl [Enter] 
tag dev prt lulr433i [Enter] 
printfilename.ext [Enter] 




After following the previous steps, your file should either 
begin printing or be saved to disk. 


Checking 
on Your 
Print Job 


If your mainfirame session is configured for either LUl or 
LU3 mode/you can easily check on the status of your print 
job by examining the Operator Information Area (OIA) of 
your window. This method is discussed in the next section. 
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The 

Operator 

Information 

Area 


The Operator Ilnformation Area (GM) provides information 
about the status of your print job through several messages. 
These messages are displayed below: 

4B| 3287 PRINTER EMUIATION ‘ READY TIME DATE 


All of the diaracters 
that appear within the 
Operator Information Area 
are explained In the 
"Understanding Mainframe 
Messages" chapter of your 
£XTftA! Extended Setup 
and Reference Menuat. 


When a connection to a mainframe program has been 
successfully established, the message shown above will' 
appear at the bottom of your screen. 

After receiving the above message; type in your mainframe's 
PRINT command as discussed in Steps 6 and 7 above. As 
the mainframe data is sent to your printer, the following 
message should appear in the OIA; 


4B| 3287 PRimER EMULATION - PRINTING CHAR COUNT:XXXXXXX TIME DATE 


lhe ”CHAR COUNT;XXXXXXX" field lets you know how many 
characters have been sent to your printer from the 
mainframe. 


After your mainframe file is finished printing, the OIA will 
display the "READY" message shown above. You can either 
send another mainframe file, or stop printer emulation. 
Ending Printer Emulation is discussed in the next section. 



c 


Ending Printer Emulation 

L 

L 


To stop using Printer Emulation, enter the following 

L 

If you are using 

keystrokes: 


Printer Emulaflon to send 
a mainframe file to your 

PC printer, you cannot 
send a PC file to the PC 

[(Ctrl/ Alt] [E] [P] or WsGtrl Alf/PF19 

L 

L 

printer until after you have 
finished using Printer 
Emulation and jumped 
back to your PC session. 

Or, if you prefer, you can access the Printer Emulation Menu 
by pressing [Ctrl/Alt] [P][E]. At the Printer Emulation 

[■ 

Menu,,selectoption [E] for End Printer Emulation; After 
ending Printer Emulation, the "OFFLINE" message will 
appear inthe OIA. 

L 

L 

f 

1 



Other Features 

L 


In additiomto Printer Emulation's basic features, which 
allow mainframe files to be sent to both a local PG printer 

L 


and a PC disk, EXTiM/ also provides the features described 
im the sections below. 

L 

L 

r 


Using 
Screen 
Capture 
With Printer 
Emulation 


EXTEA! allows you to use its screenicapture feature with 
Printer Emulation) without having to turn off: printer 
emulation! Screen Capture, which lets you take a snapshot 
picture of your screen and send it to either your printer or a 
disk, is discussed in more detail in (Chapter 2, "Using Extra!, 
Extended" EXTRA/ also Ms you use the DOS Print 
Screen command with printer emulation turned on. Both of 
these features should be used in between mainframe print 
jobs. 


L 

L 

L 

L 

L 

L 

I 

L 

L 
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Support for 

PA1/PA2 

Keys 


EXTJM/ supports Program Attention (PA) keys which can 
be used during printer emulation. This feature is valid for 
EUl mode only. The PA keys send commands to the 
mainframe, which vary depending on the mainframe 
application that youTe using. For example, you can use PA 
keys to tell a programTo reprint a job or to reprint a portion 
of a job. 


For more information about EXTRA!*s Printer Emulation 
feature, refer to the EXTRA! Extended Setup and Reference 
Manual or the documentation that accompanied your IBM 
3287 printer. 
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4 Using Host-Based 
File Transfer 

This chapter shows you how to transfer both text and 
binary filfes from the PG to the mainframe and from the 
mainframe to the PG. Themethod of file transfer described 
ini this chapter is callted "Host-Based" because EXTIM / 
Extended communicates withmainframe programs such as 
IBM's INE>$FmE (Send/Rbceive) or IBM's PS/GIGS 
(Transfer) to accomplish! the file transfer task. 

Since EXTIM / Extended communicates with either of these 
programs, this chapter explains how to transfer files using 
both IND$FILE Send/Receive and PS/GIGS Transfer. It also 
tells you what you need to get started and provides you with 
some examples. 


In addition to Hbst-B ased File Transfer, EXTiM / also offers 
Editor-Based File Transfer, which does not require special 
mainframe software. You can decide which method of file 
transfer is best for you from the discussion presented in this 
chapter. 
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Discussion: What You Need to Know 
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Before you begin using the file transfer instructions 
provided in this chapter, you need to know which system 
software is running on your mainframe computer. One of 
the systems, described below, must be resident om the 
mainframe before you can use EXTRAI's Host~Based File 
Transfer. Your log-om window should tell you whether you 
are using TSO; GMS, or GIGS. Gonsultyour System 
Administrator if youYe not sure which system? your 
mainframe is using. 


• MVS/TSO: This stands for Multiple Virtual! 

Storage/Time Sharing Option^ TSO is an interactive 
mainframe system that resides under the MVS 
operating system^ This system! works with lBM's TSO 
IND$FILE program- (#5665’311), which is explained ini 
the next section. 


I 

I 


• VM/CMS: This stands for Virtual 

Machine/Conversational Monitor System; CMS is an; 
interactive mainframe system that resides under the 
VM operating system^ This system works with IBM's 
CMS IND$TILE program; (#5664-281), which is 
explained in the next section. 


• Send/Receive GICS: Send/Rfeceive CICS (Customer 
Information Control System) is an interactive 
mainframe systemithat allows you to transfer files in 
the CICS operating environment using IBM's 
Send/Rfeceive program; This system works with IBM's 
CICS IND$FIEE program (#5798-DQH). 
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Which File 

Transfer 

Method? 


• PS/CICS: PS/CI(lS (Personal Services/Gustomer 
Information Control System) also resides in the GIGS 
operating environment However, unlike the methods 
discussed above, it does not work with INDSFILE 
Send/Receive, an IBM programi Instead, PS/CIGS 
works with another IBM program called Transfer 
(DISOSS) to transfer files. PS/CIGS is an IBM 
mainframe program available for the MVS (#5665-330) 
and VSE (#5666*318) operating systems. 


For everyday file transfer, Attachmate suggests using Host- 
Based File Transfer over Editor-Besed File Transfer, which.is 
explained ini Chapter 5; Gf course, if you don't have the 
appropriate software oni your mainframe, you wills need to 
use Editor-Based File Transfer. 


Keep in mind though, that editor- 
based transfer is limited to text 
files, while host-based allows 
transfer of both s text and binary 
files. If youhe not sure which type 
of files youhe working with 
(binary or text), askyour System 
Administrator. 

If you decide to transfer files using the Host-Based method, 
you also need to decide if you want to transfer files in the 
background or ini the foreground. 

Background File Transfer is easier to use thani Foreground 
File Transfer, since it provides youiwith a set of menus to 
guide you through the file transfer. It also lets you send a 
file to the mainframe (or receive one) without monopolizing 
your PC sessioni After the file transfer has begun> you can 
continue working with your PG application and check on the 
status of the file transfer at any time. 


Host and Host-Based, 

The words Host and 
Mainframe are often 
interchangeable. Host-Based 
rtfers to a program or 
pr(x:ess that is based in or 
runs from the mainframe 
computer. 





The drawbacks to using Background Filte Transfer are that it 
uses more memoiy (up td 22K more) thans Foreground File 
Transfer/ and that EXTJM/ must be configured for 
Background File Transfer before it cambe used; To configure 
EXTRA! for Background File Transfer, select Background 
File Transfer from the Configurator’s "Startup'* menu; 

With Foreground File Transfer, you must type a specific 
command after the DOS prompt, making sure to follow the 
correct syntax. Your PC session willlnotbe available again 
untili after the file transfer is finished; The Foreground File 
Transfer method is not available when using editor-based 
transfer. 

EXTRA! lets you transfer two files simultaneously by 
running a Background File Transfer in one session and a 
Foreground File Transfer in another. However, only one 
Background File Transfer can take place at a time, and only 
one Foreground File Transfer can take place at a time. 

Instructions explaining how to transfer files using both the 
Background and Foreground methods are presented later on 
in this chapter. 



r 

I 


----- i 

About IND$FILE and Send/Receive 


This section briefly explains IBM's INDSFIEE Send/Receive [ 

programs, 'l ou should understand this information before 

attempting to transfer files, either in the background or in [ 

the foreground. IND$FIILE is a mainframe program; while 

SEND and RECEIVE are PC programs that communicate [ 

withilNDSFIEE. When referring to this type of file transfer, 

IND$FILE and Send/Receive are often interchangeable ^ 


terms. 

r 

L 

There are three types of file transfers available through r 

IND$EIEE Send/Rfeceive: VM/CMS, MVS/TSO and ^ 

Send / Receive CIGS. If the mainframe uses the VM ^ 

operating system; you would use VM/ CMS; if the 

mainframe uses the MVS operating system, you would use [ 

MVS/TSO; and if the mainframe uses the GIGS operating 

system, youwould use Send/Receive GIGS., [ 


This chapter provides instructions for transferring files with 
each of these systems. 


Structured 
Fields vs. 
Buffered 
Transfer 
Mode 


IBM's Send/Receive program allbws files to be sent in either 
buffered mode or in a structured field format. If EXTRA! 
detects Extended Data Stream on the mainframe, it runs file 
transfer in structured field mode. If not, EXTRA.' runs in 
buffered mode. 


Buffered mode transfers data using the standard 3270 data 
stream, which has a limited set of characters and has to be 
translated twice during the transfer. Because of these 
properties, buffered mode is slower than structured fields. 

Using structured fields greatly reduces the overhead 
iiecessary for binary file transfer,, so files transfer faster. 


L 
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J To learn more about 
DFT mode, refer to the 
Bcfra/ tended Setup and 
Refemnce NtdnuaL 


While structured fields are supported int all environments 
thatrun EXTIM/, you mustbe in DFT mode to run it, and 
the mainframe must be configured for Extended Data 
Streami 


Evemthough EXTiM/ willautomatically select the correct 
method for Send and Receive, there may be some 
circumstances when youll want to override EXTlM/'s 
choice. To indicate that you want buffered mode, select the 
-B option from the appropriate Background File Transfer 
menu. Select the -S optionif you want to use structured 
fields, If using the Foreground File Transfer method, be sure 
to include either a -B (buffered) or a -S (structured) option in 
the file transfer command lihe. These options are discussed 
in more detail later in the chapter. 


Using Large 

Packet 

Sizes 


If you can transfer files using Structured Fields, you may be 
able to use large packet sizes to increase the speed of your 
Foreground or Background file transfer. A packet size is the 
size of the data unit transferred in a structured-field file 
transfer. Using larger packet sizes increases the speed of the 
file transfer because more data is transferred in each packet, 
so fewer packets need to be transferred. 




) Large packet i^zes 
may cause problems-with 
slower SDLG links. 


The default size is 2 kilobytes (K). By choosing 4K, 8K, or 
32K' instead, you can nearly double the speed of the file 
transfer. However, in order to use large packetsizes, your 
PG requires more memory and you must be using recent 
versions of IND$FILE, VTAM, and controller software. 
Check with your System Administrator to see if you can use 
large packet sizes to increase the speed of your file transfers. 


Has the 
Name of 
IND$FILE 
Been 

Changed? 


If the INDSFItE program has been ihstallfed on the 
mainframe using a name other thamlMDIFIEE, you must tell 
EXTRA! its new name. Consult your System Administrator 
for the proper install name and the procedure to use to give 
EXTIM/ the new name. 

You may include the following command in your 
AUTOEXEC.BAT file, or you may give the command at the 
DOS prompty before or after you have started EXTRA.'., 

set ind$file=xxxxx 

where is the name of the file. 


Refer to your DOS manual for more information about the 
AUTOEXEC.BAT file and the SET command; 


Background Host File Transfer 


J When you are using 
EMS and are configured 
for Background File 
Transfer, you may want to 
use the smallest available 
packet size {2K). This 
reduces the amount of 
conventional memory 
required to Just 3K. 


As explained atthe beginning of this chapter. Background 
File Transfer has several advantages: It's easier to use since it 
provides you with! a set of simple menus; and it Ifets you 
send a file to the mainframe (or receive one) without 
monopolizing your PC session. Background File Transfer, 
however, does use more memory (Up to 22K more) than 
Foreground Filie Transfer. 


Before you can begin usihg the Background File Transfer 
method to transfer files to and from the mainframe, check 
with your Systemi Administrator to be sure EXTRA/ has been 
configured for Background File Transfer. This optiomis 
available through the Configurator's "Startup" menui For 
more information! about configuring EXTRA/, refer to 
Chapter 3 oithe Extra! Extended Setup and Reference Manual. 
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J The SEND 
(^mmand transfers a file 
from your PC to the 
matnirame, and the 
RECEIVE command 
transfers a file from the 
matoframe to the PC. 


This section explains how to tlransfer files in the background 
using the IND$FILE and Send/Receive programs. These 
instructions apply to both VM/CMS and MVS/TSO, since 

the same menus appear for bothi They do not apply to 
IBM!s Send / Receive GICS program, whichi is discussed later 
in this chapter. 


About 

Transferring 
in CMS 


In order to transfer files in CMS, you must be in CMS 
command mode; This is also called a native CMS session. 
You cannot be in any other mainframe subsystemi When 
you^ are in;native CMS> you usually see a prompt saying 
"Ready". 


You also must turn off unsolicited CMS messages. These 
messages may interrupt the transfer process unless you 
respond to them. 

Turn off the messages by entering the following command 
on the command line of your CMS session: 

set msg off [Enter] 

To turn the messages back on after the file has been 
transferred, enter on the command line: 

set msg on [Enter] 


About Imorder to transfer files in TSO; you must be ih TSO 

Transferring command mode. This is also called a native TSO session, 
in TSO You cannot be in ISPF or any other subsystemi When you 

are imnative TSO; you usually see a prompt saying "Ready". 
If you have any questions aboutTSO and file transfer, 
consult your System Administrator. 


Sending 
from a PC to 
a Mainframe 


To transfer a file from your PC session to the mainframe, 
follow the steps below: 

1 Establish: a CMS or TSO session in any of the mainframe 
windows (A^Z)* Make sure thati you are in the correct 
mode. 

2 Jump to any window andpress the keys shown below: 


[Ctrl/ Alt] [F] [T] or WsCtrl PF15 


The Background File Transfer menu will appear, as 
shown belbw. 


. Pile transfer 

Characters Iransfeiredl B Statlisl IDLE 


Connand:: 

PC file: 
yindou ID:; 

File:: 

Options: 

fM IRANSFER COMWiD 
selections are: 

T(ll/D):TSO Editor CUpIOad^load): 

C(U/D):UlS Editor CUpltiad/DoMnload) 

!(S/R) TSO Host Filte Transfer (Send/Receiuel 

C(S/R) ,,,.,*,,,,,,,. tM Host FiIfe Transfer (Send/ReceiMsI 


ENTER (conwand)) or <otrl>Kenter> to execute, <^D> tO pit, 12:22 l/04/90| 








3 At the "Command:" prompt* type one of the following 
file transfer commands and press [Enter], 

TS for TSO Send 
CS for CMS Send 

The fiield Willi automatically be updated; to reflect the 
fulll name of the file transfer. 

4 After pressing [Enter], you Willi advance to the "PC pUg 
Specification:" prompt, as shown belbw. T)^e the name 
of the PC filfe that you would like to send to the 
mainframe, including the disk drive and path where the 
file is located, the filename, and its extension; if any, 
and press [Enter], 


“=^===^==^^=^== File Iransfep 
Characters Iransferreilt 8 Status: IDLE 


Connaiid: ISO SEND 
^ PC file: 

Vindw ID: 

Host File: 

Options: 


PC FILE specification: 


Id:]ISpathVIfilenanel.extJ 


ENTER (coMBandl) or (ctrlHenter) to execute, <esc> to quit. 1Z:23 i/W%l 



5 After typing the filename, you will be asked for the 
window short name of the mainframe session where 
your PG file will'be sent (A - Z)i After typing the short 
name, piess [Enter]. 

6 After you have entered the window short name, you 
need to give your PG file either a GMS File Name or a 
TSO Data Set Name, depending on your mainframe 
environment. The mainframe willl store your file under 
this name. 


For CMS, use the format shown below: 


filename filetype [filemode] 


where: 


jc-D The parameters 
shown ^ould be 
separated by blank 
spaces. 

FilmamB BTid filetype me 
limited to eight characters 
each. Valid characters 
inciude all alphanumeric 
characters (a-z, 0*9); 
letters are shifted to 
uppercase. You may, also 
use five special characters 
C$, ®, +, and _) unless 

they are defined as 
terminai control characters 
within your CMS profile. 

Do not use a hyphen 
within your filename. The 
hyphen is a restricted 
character. 


filename is a name that identifies the file being 
transferred to the mainframe. This parameter is 
required. 

filetype is a filename extension that identifies the 
contents of the file, for example or text This 
parameter is required, 

[filemode] is an optional parameter that tells CMS the 
name of the mainframe minidisk where you want the 
file to be stored. This parameter defaults to the ”A" 
minidisk. 

For example, a typical GMS filename would appear as 
follows: 



For TSO, use the format shown below: 


[']datasetname[(member)J['][/-pw] 




J TSO calls a file a 
d&taset The nam© of this 
file Is a cfafasefnam©. The 
datasetnama Is limited to 
44 characters. Mamber 
and pw are limited to 8 
characters each. 


Valid characters Include all 
alphanumeric characters 
(a*z, 0-9); letters are 
shifted to uppercase. You 
may also us© three special 
characters {$, #. and @), 
Do not start any node of 
the cfafasetname (userid, 
name, or type) with a 
number (0-9). 


where: 

datasetmme is a name that identifies the file being 
transferred to the mainframe. This parameter is 
required: 

[(member)] is required if the dataset is a partitioned: 
dataset. Otherwise, it is not allowed. Your System 
Administrator may require you to save your file within 
a partitioned data set. 

f/piai is the write-password of the existing TSO dataset, 
if it is write-password.protected. This parameter is 
ignored if the dataset is not write-protected. 


For example, a typical TSO Data Set Filename would 
appear as foUbws: 


filel.data(member2)/mypass 

If Qxe datasetname oi the file does notbegin with your 
userid, you must specify a "fully-qualified 
datasetname" and enclose the entire datesefname and 
fmemfcer) in apostrophes, as shown below. If the 
datasetname begins with your userid, you may omit both; 
the userid and the apostrophes. To enter a fully- 
qualified dafaset«ame with apostrophes, use the format 
shown below: 


'highnode. name, type] (member)] '[/pw] 


7 Once you have entered the mainframe filename, you 
will advance to the "Options:" prompt Type any of the 
options shown below, and press [Enter]: 

For CMS Send; 

append ascii crlf Irecln recfm{f/v} -B -S -n /D 

For TSO Send: 

append ascii: crlf lrecl(n) blksize(n) 
recfm({f/u/v}) -B -S -n space(quantity[,extent]) 
[{avblock(value)/tracks/c}/linders}] 

The options are defined in "Send Options for VM/GMS" 
and "Send Options For MVS/TSO" in this chapter. 

8* All of the fields on the screen should be filled im If you 
would like to change any of the fields before sending 
the file, simply [Tab] to the field and update the entry. 
Be sure to press [Enter] after making any changes. 

To start the file transfer, press the keys shown below: 

[Ctrl]/[Enter] 

9 After you press [Ctrl] / [Enter], the Background File 
Transfer screen will disappear. You can jump to any 
window, and you can perform other activities in any 
window except the mainframe session where your PC 
file is being transferred. Do not type into it or your 
entries willi interfere with the communication between 
the mainframe and the PG. 

You can check on the status of the file transfer at any 
time, or cancel the file transfer, by pressing these keys:: 


[Gtrl/Alt] [F] [T] 
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The file transfer screen will return, as shown below, 
displaying the status of your file transfer operation and 
the number of characters that have been transferred. It 
also williask you if you would like to cancel the 
transfer. To cancel the transfer, type [Y] after the 
prompt Type [N] or [Esc] if you would like the file 
transfer to continue. 


File TransFer 

Characters Iratisfemdr 12845 Status* IN ?mmm 


ConnaM^CKS SENIt 
PC filel c:Sword\saiiple.doc 
tfindou IDrB 
Host Fil^l pcdoc text a 
^ Options^ ascii crIf 

i)0iK)u yisH fo CANCEL WE wmmm 

ENTQt (y or n) 


EN!ER (cowmand)) or <ctrl>Henter> to executej <bsc> to pit. 12:25 1/04/30 






The "Status:" field can contaim any of the follbwihg 

messages: I 

HDIlE This message appears before a filfe ' 

transfer activity has beguni The i 

number of characters transferred will ' 

be 0. I 

IN PROGRESS The file transfer is in progress. You | 

can determine how much of the file 
has beeni transferred by the | 

"Characters Transferred:" field. 

I 

COMPLETE The file transfer is complete. The ^ 

"Characters Transferred:^’ field shows * 

the total number of characters that ^ 

were transferred. ' 

f 

ABENDED The file transfer ended abnormally. ^ 

The "Characters Transfeired:" field [ 

shows the total! number of characters 
that were transferred before it [ 

encountered a problem; and you will 
see an error message. i 

f 

After the file has been transferred, you can initiate a new file ^ 

transfer operation by repeating steps li through;9i The fields , 

on the screen^ still: will contain the entries fromi your last file 

transfer operationi To change the fields, [Tab] to the field | 

and update the entry. Be sure to press [Enter] after making 

any changes so that the old entry is removed and the new [ 

entry is recorded. 

[ 

i 

f 
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RGC6ivin9 To transfer a filfe from the mainframe to your PG session, 

from a follow the steps below; 

Mainframe 

Session to a 1 Establish! a CMS or TSO session in any of the mainframe 

PC windows (A-Z). Make sure that you are in the correct 

mode (CMS command mode or TSO command mode). 


j 


2 Jump to any window and press the keys shown below: 


[Ctrl/Alt] [F] [T] or WsGMTFlS 


J 

J 

J 

J 


J 

J 

J 

J 


1 


J 


The Background File Transfer menu willt appear, as 
shown below. 


..."" Fllfe Transfer 

Charact^i^s Transferred^ B Status! IDLE 


^ Connand!: 

PC fiife!; 
yindoy ID!: 

Host File!: 

Options!: 

FILE TSAHSFER mm 
selections are! 

T(U/D): ISO Editor (Iftiload/Doynload) 

zmr OiS Editor (Upload/Doiinload) 

KS/R) TSO Host File Irand'er (Send/Rraii^)) 

C(B/R) ,CMS Host Filte Transfer (^nd^eceiite)) 

EKUR (tomand)) or <OtrlHenter> to exeoitei <esc> to quit. i2!22 1/04/90 
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At the "File Transfer Gommand:" prompt> type one of 
the following file transfer commands and press [Inter]. 

TR for TSO Receive 
GR for CMS Receive 


The field: will! automatically be updated to reflect the 
full name of the file transfer. 


After pressing [Enter], you will! advance to the "PG File 
Specification:" prompt. Create a PC filename for the 
mainframe file being received. Be sure to include the 
disk drive and pathi name where the file will be stored, 
a filename, and an extension; which is optional; Press 
[Enter] after creating the filename. 

You then will be asked for the short name of the 
mainfi-ame session where the mainframe file is residing 
(A - Z). After typing the short name, press [Enter]. 

After you have entered the window short name; you 
willbe asked for the mainframe filename of the file 
being downloaded to your PG session. Enter either a 
CMS File Name or a TSO Data Set Name, depending on 
your mainframe environment. 



For CMS, use the format shown below: 


filename filetype [filemode] 


where; 


The paramet^s 
shown should be 
separated by blank 
spaces. 

Filenam& and ffletype am 
limited to eight characters 
each. Valid characters 
Include all alphanumeric 
characters (a-T, 0-9); 
letters are shifted to 
uppercase. You may also 
use five special characters 
C$j#, +,and_) unless 

they are defined as 
terminal r^ntrol characters 
v\^thln your CMS profile. 

Do not use a hyphen 
within your filename. The 
hyphen is a restricted 
character. 


filename is a name that identifies the file being 
transferred to the PG sessioni This parameter is 
required; 

filetype is a filename extension that identifies the 
contents of the file. For example data or text. This 
parameter is required; 

[filemode] is an optional parameter that tells GMS the 
name of the mainframe minidisk where the file is 
located. This parameter defaults to the "A" minidisk. 

For example, a typical GMS filfename would appear as 
follows: 


pcdoc text A 


For TSO, use the format shown below: 

[ 'Jdatasetnamel (member)]]'][/pw] 


where: 


J TSO calls a file a 
dataset The name of this 
file Is a cfafassfname. The 
datasetname Is limited to 
44 characters. Mdmber 
and pware limited to 8 
characters each. 


datasetname is a name that idfentifies the file being 
transferred from the mainframe. This parameter is 
reqpimd* 


[(member)] is required if the dataset is a partitioned 
dataset. Otherwise, it is not allowed. Your System 
Administrator may require you to save your file within 
a partitioned data set 


[/pw] is the read-password of the existing TSO dataset, 
ifdt is read-password-protected; This parameter is 
ignored ifi the dataset is not read-protectedi 


For example, a typicali TSO Data Set Filename would 
appear as follows: 

file!. data(memher2)/mypass 


If the datasetname of the file does not begihiwith your 
userid; you must specify a "fully-qualified 
datasetname" and enclose the entire dotesefname and 
(member) m apostrophes, as shown belOw. If the 
datasetname he^s with your userid; you may omit both 
the userid and the apostrophes. To enter a fully- 
qualified datasetname with apostrophes, use the format 
shown below; 


'highnode. name.typel(member)] '[/pw] 

Once you have entered the mainframe filename, you 
will advance to the "Options:" prompt. Type in any of 
the options shown below, and press [Enter], 


For CMS Receive: 

append ascii crlf 


For TSO Receive; 


append ascii crlf 

Each of these options are described in: the "Receive 
Options for VM/GMS" and "Receive Options For 
MVS /TSO" sections of this chapter. 



“J 


-J 


J 

J 

J 


J 

J 

J 


J 

J 

■ 1 


•1 

-J 

! 


8 Alliof the fields on the screen should be filledan (the 
options field can remain blank if no options were 
selfected). If you want to change any of the fields before 
starting the file transfer, simply [Tab] to the field and 
update the entry. Be sure to press [Enter] after making 
any changes. 

To start the filfe transfer, press the keys shown below: 

[Ctrl]/[Enter] 

9 After you press [Ctrl]/[Enter], the Background File 
Transfer screen willi disappear. You canjump to any 
window, and you can perform other activities in any 
window exceptthe mainframe session where your PC 
filie is being transferred; Do not type into it or your 
entries williinterfere with the communication between 
the mainframe and the PC. 


You can check on the status of the file transfer from any 
session^ and at any time> or you may cancef the file 
transfer, by pressing the keys showni below: 


[Ctrl/Alt] [F] [T] 


The file transfer screen willireturn> displaying the status 
of your file transfer operation and the number of 
characters that have been transferred. It also will ask 
you if you would like to cancef the transfer. To cancel 
the transfer, type [Y] after the prompt. Type [N] or 
[Esc] if you would like the file transfer to continue. 


J 

J 


1 
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The "Status:" field can contaim any of the following 
messages: 


This message appears before a file 
transfer activity has begum The 
number of characters transferred will: 
be 0: 


IN PROGRESS The file transfer is in progress. You 
ean dfetermine how much of the file 
has been transferred by the 
"Gharacters Transferred:" field; 


COMPLETE The file transfer is complete. The 

"Characters Transferred:" field shows 
the totali number of characters that 
were transferred. 

ABENDED The file transfer ended' abnormally. 

The "Characters Transferred:" field: 
shows the total! number of characters 
that were transferred before it 
encountered a problem. The menu 
will give you an error message. 

After the file has been transferred, you can initiate a new file 
transfer operation by repeating Steps 1 through 9, The fields 
on the screen still! will contain the entries from your last file 
transfer operation. To change the fields, [Tab] to the field 
and update the entry. Be sure to press [Enter] after making 
any changes so that the old entry is removed and the new 
entry is recorded. 


To Cancel a 
Background 
File Transfer 


If you have not yet sent the file with the [Ctrl]/[Enter] 
command, you can exit the Background File Transfer menu 
by pressing [Esc]. To cancel the file transfer after pressing 
[Ctrl]/ [Enter], follow the steps provided in Step 9. 
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Background 
File Transfer 
Notes 


EXTRA! lets you transfer two files simultaneously by 
running a Background Filfe Transfer in one mainframe 
session and a Foreground File Transfer in another. 
However, only one Background File Transfer can take place 
at a time, and only one Foreground File Transfer can take 
place at a time. 


The Gombinedi number of characters entered in the "PG File:", 
"Window lD:", "Host FUe:" and "OpHons:" fields cannot 
exceed 63 characters. The hyphen character cannot appear 
in any of these fields, except for the "Options:" field. 


Foreground File Transfer with CMS 

This section explains how to transfer files in the foreground 
withi GMSi Unlike Background File Transfer, Foreground 
File Transfer dOes not provide menus to guide you through! 
the file transfer process. You must type a specific command 
after the DOS prompt, making sure to follow the correct 
syntax. In!addition> your PG session willi not be available 
again; untili after the file transfer is finished. However, it 
does use lass memory (up to 22K) than Background File 
Transfer and EXTRA! does not need to be specially 
configured for Foreground File Transfer before it can be 
used. 


The SEND command transfers a file from your PG to the 
mainframe. The REGEWE command transfera a file from 
the mainframe to the PG. Each command is discussed 
separately and in more detaililater in this section: 


The syntax (format) of the CMS SEND command is; 




i Do not use a 
filename with a hyphen (-). 
The l^phen Is a restricted 
character. 


The syntax of the CMS RECEIVE command is:: 

[a:]receive[d:][path]faename[.ext][w:]fnft^ 

After typing the appropriate command; press [Enter]. 


Standards, This section explains commonly-used CMS command terms 

Command and options, and provides examples of the commands. 

Terms, and 

Options For transferring text files, there are two recommended 

options: ascii: and crlf These options ensure that your file 
will be readable on the PC or the mainframe. 

Here are the standards used in the command syntax: 

• Brackets [ ] indicate optional parameters. You do not 
enter the brackets themselves. 

• Enter periods, colons, and parentheses as shown. When 
they appear in brackets, enter them only if you are 
using the accompanying options. 

• A left parenthesis in the command line indicates that 
options follow. 


About 

Transferring 
in CMS 


In order to transfer files in CMS, you must be in CMS 
command mode. This is also callfed a native CMS session. 
You cannot be in any other mainframe subsystem. When 
you are ininative CMS, you usually see a prompt saying 
"Ready". 


4-24 


Sending 


from a PC to 
a CMS 
Mainframe 
Session 


Before you can send files from the PG to a GMS mainframe 
session^ you must turn off unsolicited GMS messages. These 
messages may interrupt the transfer process unless you 
respond to them; 

Turn off the messages by entering the following command 
on the command line of your GMS session: 


setmsgoff [Enter] 

After you have finished transferring files, you can turn the 
messages back on by entering the following command line: 

setmsg on [Enter] 

To transfer a file from your PG to a GMS mainframe session: 


1 Establish a GMS session in. one of the mainframe 

windows (A-Z). You must be in GMS command mode 
(that is, native CMS)i 


2 Jump to your PG window. 


CMS will not 
accept a ftlename with a 
period. You must have a 
space in order for the 
ffler^ame to be recognized. 


3 To send your file to the mainframe, use the following 
format. These parameters are defined later in this 
section: 


Here's an example. The file is being sent from the PC's 
Drive A to the mainframe session! in window G. The PC 
filename is sample, txty, the CMS filename is my doc; the 
CMS filetjrpe is text. 

The Ready prompt in window C indicates that you are 
in CMS command mode. (If "Ready" does not appear in; 
the window, use full-screen mode to verify that it is 
there;) Notice that there are three options included 
with the command in this example: 


rBl-'SESSIONl^ - 





Ready 







CrSEXIRAXsend aisanplc.txt d nydoc text (append ascii crlf 





12 : 41 ; 1/04/90A 


4 After typing the command line, press [Enter]. File 
transfer starts immediately. Messages are displayed to 
inform you of the progress of the file transfer. 

You can use other windows while the transfer takes 
place, but do not enter an)rthing into the PC window or 
the file transfer mainframe windbw until^ the file 
transfer is complete. 




The SEND Command Line Defined 




JlfSEND.COM is not 
in the current drive and 
subdirectory, DOS may 
use the •send" cKJmmand 
of a different InstaJled 
application, rather than 
EXTftArs SEHO 
command. 


[a:] 


SEND 


m 


[path] 


filename 

[.ext] 


[w:] 


/« 


ft 


Is a disk drive Specifier that indicates where 
the SENDiCOM file resides. It is not 
needed if the SEND.GOM is in the current 
drive and subdirectory. 

Is the command that you use to start file 
transfer to the mainftiame. 

Is ani optional drive specifier for the PC file 
to be sent If not specified) the current 
drive and subdirectory are usedi 

Is the directory path of the PC file to be 
sent. If not specified, the current DOS 
directory is usedi 


Is the PC filename to be sent. 


Is the PC filename extension) if any. If the 
PC filename has an extension) you must 
include it in this commands 


Is the mainframe window in which you 
have established the CMS session. If not 
specified, the first mainfi-ame sessioni 
window is assumed. 

Is a name that: identifies the filfe being 
transferred to the mainframe. This 
parameter is required. 


Is an extensioni to the filename that 
identifies the contents of the file, for 
example data text This parameter is 
required. 



Ifm] 




J Options begin with a 
left parenthesis. 


[(options] 


Is an optional parameter that tells CMS the 
name of the mainfipame minidisk where 
you want the file to be stored. This 
parameter defaults to the "A" minidisk. 


Are described on the following pages. 


SEND Options for CMS 




J If append Is not 
used when the CMS 
fllensBne already ^tets on 
the mainframe, the 
existing file will be 
replaced by the uploaded 
file. 


The CMS SEND command syntax includes the following 
options (options must begin with a left parenthesis): 


append Lets you append the uploaded file to the 

end of ani existing CMS file. The append 
option is ignored if the specified CMS file 
does not exits. 


«sc» Specifies that files storedun ASCII om the 

PC be converted to EBCDIC during before 
transfer. The aseii option is recommended 
ifi the file is to be readable on i the 
mainframe. 


crlf Specifies that carriage retum/lihe feed 

character-pairs present ini the PC file should 
be deleted before being stored on the 
mainframe. Usually, alphanumeric data on 
the PC contains a cr//character pair at the 
end of each line to denote the end of each 
record. Deleting these character pairs using 
the crlf option lets you read the mainframe 
version of the file more easily. 



Irecl n Specifies the logical record length; of the 

mainframe file, where n is the number of 
characters in each record; PC records 
longer than n will be split into multiple 
mainframe records. If /red is omitted, the 
default is 80 for new files. For existing files, 
Irecl is ignored. 


recftnf 




i Use of the mcfim v 
optton without the 
option Is recommended 
v^en padding of 
mainframe records or 
deletion of trailing spaces 
must not occur. 


recfm v 


-B 


Specifies that the maihfirame file wUli 
contain fixeddength; records. Records are 
padded with space characters if they are 
shorter than that specified; withired or the 
default length; This is the default for new 
files unless crlf is specified; 

Specifies that the file will; contain variable 
length records. This is the default for new 
files when cr//is specified. 

Use this option only if it is necessary not to 
use Struct^rred Fields. 


-S 




J A larger packet size 
transmits data more 
quickly than a smaller size, 
but It requires more PC 
memory and recent 
versions of INOSFILE and 
Controller software, and It 
may cause problems In 
slower SDLC links. 


-2, -4, -8, -32 


Specifies structured field file transfer. It is 
only valid in the DFT environment. It is 
required only once for a bisync-connected 
Gontrollter where the mainframe has not 
senta Query prior to using SEND, 

One of these options can be used if you are 
using Structured Field file transfer. This 
option specifies the packet size, iu 
kilobytes, of the information being 
transmitted. The default packet size is 2K. 


/D With this option, your send command line 

waits lOiseconds before it is sent to the 
host. This option is helpfiiliifi you want to 
send a file to the mainframe, but the 
mainframe is not ready to receive the file. 


Receiving 
from a CMS 
Mainframe 
Session to a 
PC 


To transfer a filfe from the mainframe to your PC:: 

1 Establish a CMS session in any of the mainframe 

windows (A-Z), The session mustbe iniCMS command 
mode (that is, native CMS). 


2 Jump to the PC window. 


3 At the DOS prompt, enter the following command: 
(These parameters are defined later in this section) 


Here's an example. The file is being sent fromi the 
mainframe in. window C to the PC's Drive A. The CMS 
filename is mydoc; the CMS filfetype is text. When 
EXTRA! receives the file, it will: write it to the file 
sample.txt. 

The Ready prompt in window C indicates that you are 
in CMS command mode. (If "Ready" does not appear in: 
the window, use full-screen mode to verify that it is 
there.) Notice that there is one option included with the 
command im this example;: 
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I 



C:S£XT}M>peceiue a:saRple.t)rt c: nydoc text (append 


I--—--J 

12:41 vat/sm 


4 After typing the command line, press [Enter]. File 

transfer starts immediately after you enter the RECEIVE 
command. Messagesare displayed to inform; you of the 
progress of the file transfer. 

You can use other windows while the transfer takes 
place but do not enter anything into the PC window or 
the file transfer mainframe window until! the file 
transfer is complete. 














The RECEIVE Command Line Defined 


If RECEIVE.COM te 
not in the current drive and 
subdirectory, DOS may 
use the “receive** 
command of a different 
installed application, rather 
than ©aB4fs RECEIVE 
command. 


la:] 


RECEIVE 


m 


[path] 


filemme 

[.ext] 


[w:] 


fn 

ft 


Is an optionaltdisk drive specifier that 
indicates where the RICEEVE.CQM file 
resides. Not needed if the RECEEVE.GOM 
file is im the current drive and subdirectory. 


Is the command that you use to start file 
transfer from the mainframe; 

Is an optional diive specifier for the PC file 
to be received. If not specified, the current 
drive and subdirectory are used; 

Is the directory path of the PG file to be 
received; If not specified, the current DOS 
directory is used; 

Is the PG filename to be received; 

Is the PG filename extension; if any. If the 
PG filename has amextension, you must 
include it im this command. 


Is the mainframe window in which; you 
have established the CMS session; If not 
specified, the first mainframe window is 
assumed; 

Is a name that identifies the mainframe file 
being transferred to the PG session. This 
parameter is required; 

Is an extension; to the filename that 
identifies the contents of the maihframe 
file.. For example data or text. This 
parameter is required; 



u 

u 


Li 


[fm] 

Is ani optional parameter that tells GMS the 
name of the mainframe minidisk where the 

U 



file is located. This parameter defaults to 
the "A" minidisk. 

u 

u 

Options begin with a 
left parenthesis. 

[(options] 

Are described! on the folio wing pages. 


RECEIVE Options for CMS 


□ 


f '1 


The CMS RICEIVE command S 3 mtax includes the following 
options (left parenthesis in syntax is required): 


J It append ts not 
specffled and the specified 
PC file already exists, the 
received file will replace 
the existing PC file. 


append 


ascii 


Specifies that the received file is to be 
appended! to the end of an existing PC file. 

Specifies that the EBCMG-stored 
mainframe file be converted to ASCII 
before transfer. The ascii option is 
recommended if a text file is to be readable 
on the PC. 


I 1 


crlf Specifies that traiUhg spaces in the 

mainframe file records are to be deleted 
and that carriage return/line feed character 
pairs are to be inserted at the end of each 
record. Grlf mode is recommended if the 
file is to be readable on the PC. 

-B Use this option only if it is necessary to not 

use Structured Fields. 


1 
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-s 


J A larger packet size 
transmits <Jata quicker 
than a smaller size, but It 
requires more PC memory 


and recent versions of 
IND$FILE and Controller 


softwwe, and it may cause 
problems with slower 
SDLC links. 


-2,-4,-8,-32 


This optiomis only valid imthe lDFT 
environment. It is required only once for a 
bisync-GOnnected controller when the 
mainframe has not sent a Query prior to 
using RECEIVE. 

One of these options can be used if you are 
using Structured Field filfe transfer., This 
option specifies the packet size, im 
kilobytes, of the information being 
transmitted; The default packet size is 2K. 


Foreground File Transfer with MVS^SO 

This section explains how to transfer files in the foreground 
with TSO; Unlike Background^ File Transfer, Foreground 
File Transfer does not provide menus to guide youi through 
the file transfer process. You must type a specific command 
after the DOS prompt making sure to follow the correct 
syntax. 


The SEND command transfers a file fromiyour PC to the 
mainframe. The RECEIVE command transfers a file from 
the mainframe to the PC. Each; command is discussed 
separately and in more detail later in this sectibm 

The syntax (format) of the TSO SEND command is: 

[a:]send [d:][path]fn[.ext] [w:][']dsn[ (mbr) ][ '][/pw] [options] 

The syntax of the TSO RECEIVE command is: 


After typing your command line, press [Enter]. 



Standards, 
Command 
Terms, and 
Options 


About 

Transferring 

inTSO 


This sectibni explains commonly-used TSO command terms 
and options, and provides examples of the commands. 


For transferring text files, there are two recommended 
options: ASOI and CRTF. These options ensure that your 
file will be readable on the PG or the mainframe. 


Here are the standards used in the command S)nntax: 


• Brackets [ ] surround optional parameters. Do not enter 
the brackets themselves. 

• Enter commas, periods, colons, and parentheses as 
showni When; they appear in brackets, they are entered 
only if the accompan 5 dng options are used; 


The specific parameters associated with the TSO SEND and 
RECEIVE commands are described in the following pages. 


In order to transfer files in TSO; you must be in TSO 
command mode. This is also called a native TSO session. 
You cannot be in ISPF or any other subsystem. When you 
are in native TSO> you see a prompt sa)dng "Ready". If you 
have any questions about TSO and file transfer, consult your 
System Administrator. 



Sending 
from a PC to 

also 

Mainframe 

Session 


To transfer a file from your PC to a TSO mainframe session:: 

1 Establish a TSO session: ihi any of the mainframe 

windows (A-Z) . You must be in: TSO command mode 
(thatis, notin lSPF or other subsystem but in native 
TSO): 


2 Jump to your PC window. 

3 At the DOS prompt, t 3 ?pe your command line using the 
following format. These parameters are defined later in 
this section: 


period between the [mJSEND [d:][pcith]jti[.£xt] [']dsn[(tnb>‘)][ '][/pw] [options] 

mainframe filename 
(dataset name) and its 
extension (if an extension 
is used). 



Here's amexample. A ffle is being sent from Drive A 
the PG to the mainframe in window G. The PG 
filename is sample, txt The TSO datasetname is 
my doc, text. 

The Ready prompt in window G indicates that you are 
in TSO command mode* (If"Ready" does not appear in 
the window, use fulbscreen mode to verify that it is 
there.) Notice that there are three options {ascii, crlf, -s) 
includediwith the command imthis example: 



4 Press [Enter] after typing the command line. File 
transfer starts immediately after the SEND command 
has been entered* Messages are displayed to inform 
you of the progress of the file transfer. 

You can use other windows while the transfer takes 
place but do not enter anything into the PG window or 
the file transfer mainframe window until the file 
transfer is complete. 
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The SEND Command Line Defined 




/ If SEND.COM is not 
In the current drive and 
subdirectory, DOS may 
use the "send* command 
of a different Installed 
application, rather than 
EximrsBBm 
command. 


[a:] 


SEND 


[path] 


filename 

[.ext] 


[w:] 


dsn 


[(member)] 


Is a disk drive specifier that indicates where 
the SENDiGOM file resides. It is not 
needed if the SENDiGOM. is in: the current 
drive and subdirectory. 

Is the command that you use to start file 
transfer to the mainframe. 

Is an optional drive specifier for the PG file 
to be sent. If not specified, the current 
drive and subdirectory are used. 


Is the directory path of the PG file to be 
sent. If not specified, the current DOS 
directory is used. 


Is the PG filename to be sent. 

Is the PC filename extension, if any. If the 
PC filename has an extension, you must 
include it in this command. 

Is the mainframe window in: which you 
have established the ISO session. If not 
specified, the first mainfi:'ame window is 
assumed. 

Is the TSO dataset name you assign: to the 
file when you send it to the mainframe. 
This parameter is required. 

Is required if the dataset is a partitioned 
dataset. Otherwise, it is not allowed.. Your 
System Administrator may require you to 
save your file within a partitioned dataset. 
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Hyw] Is the write-password of the existing TSO 

dataset, if it is write-password^-proteeted. 
This parameter is ignored if the dataset is 
not write-protected. 

For example, a typical TSO Data Set 
Filename would appear as follows: 

filel.data(member2)/mypass 

[options] Are described on the following pages. 

lithe datasetname of the file does not begin with your userid, 
you must specify a "fully-qualified datasetname" and enclose 
datasetname and (member) in apostrophes as shown in the 
format below. If the datasetname begins with your userid, 
you may omitboth the userid and the apostrophes. 

'highnode. name. type[(member) ] '[Ipw] 


SEND Options for TSO 




J If you do not use 
append and the TSO 
dataset name already 
exists on the mainframe, 
ttte existing file will be 
replaced by the uploaded 
file. You may not use 
append for members of a 
partitioned dataset. 


The TSO SEND command syntax includes these options: 

append Lets you append the uploaded file to the 

end of an existing TSO file. The append 
option is ignored if the specified TSO 
dataset does not exist, append is not 
allowed if the TSO dataset is a partitioned 
dataset. 


ascii Specifies that files stored in ASCII on the 

PC be converted to EBCDIC during transfer 
to the mainframe. Usually, alphanumeric 
files are stored in ASCII on the PC and 
EBCDIC on the mainframe. The ASCII 
option is recommended if you want the file 
to be readable on the mainframe. 



crlf Specifies that carriage retum/lihe feed 

character pairs present in the PG file are to 
be dele ted from i the mainframe file; Text 
data in the PG files commonly have a crlf 
character pair at the end of each lihe to 
denote the end of each record. Removing 
these character pairs with the crlf option 
makes the files readable on the mainframe. 


lrecl(n) Specifies the Logical Rbcord Length of the 

mainframe file, where n is the number of 
characters in each record; SeUength PG 
records longer than « and variable-length 
records longer than n-4 willi be split into 
multiple mainframe records. If you omit 
/rec/,.the default is 80 for new files. For 
existing files, Irecl is ignored. 

blksize(n) Specifies the block size of the mainframe 

dataset) where n is the lengthiin bytes of a 
data block. If you are appending or 
replacing a dataset, bZfoize is ignored. 


recfm(f) 


J For existing files, 
the option Is 
ignored. 


It Is recommended that 
you use the recfmfi^ 
option without the crif 
option when you must 
avoid padding of 
mahiframe records or 
deletk?n of trailing spaces. 
For example, binary 
{program) files contain 
veu'iable length records. 


recfm(u) 


recfm(v) 


Specifies that the mainfmme file will 
contain fixed^engthirecords. Rieeords are 
padded with space characters if they are 
shorter than that specified with Jred or the 
default length; This is the default for new 
filtes unless crlf is specified; 

Specifies that the mainframe file will 
contain records of undefined length; 


Specifies that the mainframe file will 
contain records of variable length. This is 
the default for new files when cr//is 
specified; 



Li 

u 

U 

U 


r 


u 


F 1 


r 1 



-B 

Use this option only if it is necessary not to 
use Structured Fields. 

A larger packet size 
transmits data quicker 
than a smaller size, but it 
requires more PC memory 
and recent versions of 
IND$F1LE and Controller 
software, and it may cause 
problems in slower SOLO 
links. 

-S 

Specifies Structured Field File Transfer. 

This option is only valid imthe DFT 
environment. It is required only once for a 
bisync-connected controller where the 
mainframe has not sent a Query prior to 
usingSENDi 

-2, -4,-8,-32 

One of these options can be used if you are 
using Structured Field file transfer. This 
option specifies the packet size, ini 
kilobytes, of the information being 
transmitted. The default packet size is 2K. 


space Specifies the amount of space you want to 

be allocated for a new dataset. If you use 
space, use the follbwing syntax: 

space(quantityl,extent}) [avblock(value) or 
tracks or 
cylinders] 


For example: 
space (20,10) tracks 

If you do not specify one of the options 
iollowingextent),.avblock(value), tracks, or 
cylinders, the default is avblock(blksize). The 
space option is ignored for existing datasets. 

Consult your System Administrator for 
moi« information and for the space option 
to use. 


r 
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Receiving 
from a TSO 
Mainframe 
Session to a 
PC 


To receive a file from a TSO mainframe sessiom to your PG: 

1 Establish a TSO session! in one of the mainframe 

windows (A^Z)., You must be in TSO command mode 
(thatis, not in ISPF or any other subsystem but in native 
TSO). 


2 Jump to the PC window. 

3 Atthe DOS prompt, type your command line using the 
following format These parameters are defined later in 
this section: 


[a:]receive[d:][path]fn[.ext][w:][']dsn[(mbr)}['][/pw] [options] 

Here's an example. The file is being sent from the 
mainframe in window G to Drive A in the PG. The PG 
filename is sample, txt The TSO dataset name is 
my doc. text. 
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The Ready prompt imwindow C indicates that you are 
in TSO command mode. (If "Ready" does not appear in 
the window, use fulhscreen mode to verify that it is 
there.) Notice that there are two options {ascii and crlf) 
included with the command- in this example:: 



4 Press [Enter] after typing your command line. 

Filfe transfer starts immediately after the RECEIVE 
command has been entered: Messages are displayed to 
inform you of the progress of the file transfer. 

You can use other windows while the transfer takes 
place but do not enter anything into the PC window or 
the file transfer mainframe window until the file 
transfer is complete. 
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If RECE1VS.COM is 
not in the current drive and 
subdirectory, DOS may 
us© the "receive"' 
command of a different 
Installed application, rather 
than EXTRAtsmOENB 
command. 


The RECEIVE Command Line Defined 

[a:] Is an optional disk drive specifier that 

indicates where the REGEIVE.COM file 
resides. Not needed the RECEIVE.GQM 
file is im the current drive and subdirectory. 

RECEIVE Is the command that you use to start file 
transfer from the mainfi'ame. 

[d:] Is an optional drive specifier for the PG file 

to be received. If not specified, the current 
drive and subdirectory are used; 

[path] Is the directory path of the PG file to be 

received. If not specified, the current DOS 
directory is usedi 

filename Is the PG filename you want to receive. 

[.ext] Is the PG filename extension, if any. If the 

PG filename has an extension, you must 
include it in this commandi. 

[w:] Is the mainfirame window in which; you; 

have established the TSO session. If not 
specified, the first session window is 
assumed. 

dsn Is the mainframe filfename (dataset name) 

of the file being transferredi This 
parameter is required. 

[(member)] Is required if the dataset is a partitioned 

dataset. Otherwise; it is not allowed. Your 
System Administrator may require you to 
save your file within a partitioned dataset. 
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[/pw] Is the read^password of the existing TSO 

dataset, if it is read-password-protected. 
This parameter is ignored if the dataset is 
not read'protectedi 

For example, a t3?pical TSO Data Set 
Filename would appear as follbws: 

filel.data(member2)/mypass 

[options] Are described on the following pages. 

If the datasetname of the file does not begin: with your userid, 
you must specify a "fully-qualified datasetname" and enclose 
the entire datasetname and (member) in apostrophes, as shown 
below, li the datasetname begins with your userid, you may 
omit both the userid and the apostrophes. To enter a fully- 
qualified datasetname with apostrophes,,use the format 
shown below; 


'highnode. name, type](member)]'[/pw ] 


RECEIVE Optibns for TSO 


^11 


3 If append Is not 
specified and the speclfii 
PC file already exists, th 
received file will replace 
the existing PC file. 


The TSO RECEIVE command syntax includes the following 
options: 

append Specifies that the received file is to be 

appended to the end of an existing PC file. 

ascii Specifies that the EBCDIC-stored 

mainframe file be converted to ASCII 
before transfer. The ascii option is 
recommended if you want the file to be 
readable on the PC. 



crlf Specifies that ttiailihg spaces in the 

mainframe file records are to be deleted 
and that carriage return/line feed character 
pairs are to be inserted at the end of each 
record. Crlf mode is recommended if you 
want the file to be readable on the PC. 

-B Use this option only if itis necessary notto 

use Structured! Fields. 

Specifies Structured Field File Transfer. 

This option is only valid in: the DPT 
environment. Itis required only once for a 
bisync-connected controller where the 
mainframe has not sent a Query prior to 
using RECEIVE. 

One of these options can be used if you ctfe 
using Structured Field! file transfer. This 
option specifies the packet size; ihi 
kilobytes, of the information being 
transmitted. The default! packet size is 2K. 




J A larger packet size 
transmits ciata more 
quickly than a smaller size, 
but It requires more PC 
memory, and recent 
versions of IND$FiLE and 
Controller software, and It 
may cause problems In 
slower SDLC links. 


-2, -4,-S,-32 
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Foreground File Transfer with Send/Receive CICS 


j To transfer flies 
using the FS/CfCS 
(DISOSS) file transfw 
method, please refer 
ahead to *How to Transfer 
Files with PS/CICS* to this 
chapter. 


This section explains how to transfer files im the foreground 
using IBMIs Send/ Receive program in the CKCS 
environment. Unlike Background File Transfer, Foreground 
File Transfer does not provide menus to guide you through 
the file transfer process. You must type a specific command 
after the DOS prompt, making sure to follow the correct 
syntax, which is shown in this section. 




J Do not use a 
filename with a hyphen (•). 
The hyphen Is a restricted 
character. 


The SEND command transfers a file from your PC to the 
mainfirame. The RECEIVE command transfers a file from, 
the mainframe to the PC. Each command is discussed 
separately and im more detail later in this section. 

The syntax (format) of the CICS SEND' command is: 

[a:]send[d:][path}PCfilemme[.ext] [to:} host filename [(options] 


The syntax of the CICS RECEIVE command is:: 

[a:]receive [d:}[path]PCfilename[.ext] [to:] host filename [(options] 


After typing the appropriate command/press [Enter]. 


Standards, 
Command 
Terms, and 
Options 


This sectibni explains commonly-used CICS command terms 
and options and provides examples of the commands. 

For transferring text files, there are two recommended' 
options: flscji and cW/. These options ensure that your file 
will be readable on the PC or the mainframe. 


Here are the standards used im the command: syntax: 

• Brackets [ ] indicate optional parameters. You do not 
enter the brackets themselves. 
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• Enter periods, colons, and parentheses as shown. When 
they appear in brackets, enter them only if you are 
using the accompan 5 dng options. 

• A left parenthesis indicates that options follow. 


Sending 


From a PC 
to a CICS 
Mainframe 
Session 


1 Establish a GICS session ini one of the mainframe 
windows (A-Z)i You must be in GICS command mode. 

2 Jump to your PC windbw. 

3 To send your file to the mainframe, use the following 
syntax. These parameters are defined later in this 
seetibn:: 

[a:]send [d;][path]filemme[.ext] [w;] host filename [(options] 

4 After typing the command line, press [Enter], 

File transfer starts immediately. Messages are 
displayed to informi you of the progress of the file 
transfer. 


You can use other windows while the transfer takes 
place, but do notenter anything into the PG window or 
the file transfer mainframe window until: the file 
transfer is complete. 
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The Send Command Line Defihed 


If SEND.COM Is not 
In th© current drive and 
subdirectory, DOS may 
use the "swid" command 
of a different Installed 
application, rather than 
©OlFMfsSEND 
command. 


[a:] 


SEND 


m 


[path] 

filename 

[.ext] 

lio:] 


host filename 


j Options begin with a 
left parenthesis. 


[(options] 


Is a disk drive specifier that indicates where 
the SENIDiGOM file resides. It is not 
needed if the SEND^GOM is in the current 
drive and subdirectory. 


Is the command that you use to start file 
transfer to the mainframe. 

Is an optional drive specifier for the 
location of the PG file to be sent. If not 
specified, the current drive and 
subdirectory are used. 

Is the directory path of the PG file to be 
sent. If not specified, the ciurent DQS 
directory is used. 


Is the PC filename to be sent. 


Is the PC filename extension, if any. 

Is the mainframe window in which you 
have established the GIGS session. If not 
specified, the first mainframe session 
window is assumed. 

Is the mainframe filename where data is to 
be sent. 

Are described later in this chapter in 
"Common Send And Receive Options For 
GIGS." 


Receiving 
from a CICS 
Mainframe 
Session to 
Your PC 


1 Establish a CICS sessibn in any of the mainframe 
windows ( A-Z). The session must be in CICS command 
mode. 

2 Jump to the PC window. 

3 Enter the following command line at the DOS prompt. 
These parameters are defined later in this section: 

[a:]receive [d;][path]filemme[.ext] [w:] host filename [(options] 

4 ; After typing the command line, press [Enter]. 

File transfer starts immediately. Messages are 
displayed to inform you of the progress of the filfe 
transfer. 


You can use other windows whilfe the transfer takes 
place, but do not enter anything into the PC window or 
the file transfer mainframe window until the file 
transfer is complete. 
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The Receive Command Line Defined 


If RECEIVE.COM is 
not in th© current drive and 
subdirectory, DOS may 
use the ■i^ecelve" 
command of a different 
installed application, rather 
than EXrmVs RECEIVE 
Kjmmand. 

[a:l 

Is an optional! disk drive specifier that 
indicates where the REGEIVE.GOM file 
resides. This is not needed if the 
REGEIVE.GOM file is in the current drive 
and subdirectory. 


RECEIVE 

Is the command that you use to start file 
transfer from the mainframe. 


m 

Is amoptional drive specifier for the PG file 
to be received^ If not specified} the current 
drive and subdirectory are used. 


[path] 

Is the directory path of the PG file to be 
received. If not specified, the current DOS 
directory is used. 


filename 

Is the PG filename to be received. 


[.ext] 

Is the PG filename extension) if any. 


Iw.l 

Is the mainframe window iniwhich you 
have established! the GIGS session. If not 
specified, the first mainfirame window is 
assumed. 


hostfilename 

Is the name of the file to be retrieved from 
the mainframe transfer file. 

Options begin with a 
left parenthesis. 

[(options] 

Are described on the following pages. 



Gommon SEND And RECEIVE Options For GIGS 

The following section! lists options used by both SEND and 
REGEIVE. Options that are unique to one environment are 
noted next to the optibni (Options must begin with a left 
parenthesis.) 

append Lets you append the downloaded file to the 

(Receive only) end of amexisting PC file. 

ascii Data is translated from: ASCII to EBCDIC 

with the SEND option^ and from EBCDIC 
to ASCII; with the RECEIVE optiom The 
flsdi option is recommended if the file is to 
be readable on the mainframe and PC. 

binary The data ihithe file to be sent or received is 

binary data. That is, data that is not 
readable. It is sent "as is" without any 
translation. 

blank This option specifies that trailing blanks 

(Receive only) are not to be deleted. 

crlf Specifies that carriage return/line feed 

(Send only) character pairs present in the PC file should 
be deleted before being stored on the 
mainframe. Usually, alphanumeric data on 
the PC contains a crl/character pair at the 
end of each line to denote the end of each 
record. Deleting these character pairs using 
the crlf option lets you read the mainframe 
version of the file more easily. 


Some of these 
optfons may not apply to 
your version of CICS. 
Refer to your mainframe 
documentation for details. 


If append Is not 
used, the receiving fils will 
be replaced by the 
downloading CICS file. 
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crlf Specifies that trailing spaces inithe 

(Receive only) mainframe file records are to be deleted 

and that carriage return/line feed character 
pairs are to be inserted at the end of each 
record, cr//mode is recommended if the 
file is to be readable on the PG. 

DCDF=dcdfname Specifies the Data Conversion Descriptor 
File (DCDF) if field-level data conversion: is 
to be performed during file transfer. DCDF 
must be present in the Host Transfer File 
and must be owned by the user issuing the 
SEND or RECEIVE. 

Once you receive a file owned by you, itis 
deleted from the host transfer file after it 
has been copied to the PC file. Delete is the 
default for files owned by you. (Files 
received from other users with the FROM= 
option are never deleted.) 

FORi=USIDN This option allows you to share a file with 
(Send only) up to eight users. It can only be accessed 
by users who are logged on to GIGS with a 
user ID specified in the USJDN parameter. 

FROM=USID Retrieves a filte that was stored as a public 
(Receive only) filfe or that another user shared with youi 
LfS/D is the GICS/DOS/VS ID of the 
person: who owns the file. 

HTF The fileis stored in/received from the host 

transfer file. {HTF, rather than TS, is the 
defaultL) 

KEEP Specify KEEP it you do not want the file to 

(Receive only) be deleted. 


DELETE 
(Receive only) 


J 

J 
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NOCRIF 

NOREPLACE 
(Send only) 

NLS=nn 

PRIVATE 
(Send only) 

PUBLIC 
(Send only) 

REPLACE 

TS 

-B 

-S 


The PG file to be sent or received does not 
consist of lOgicalirecords. No deletion or 
ihsertiomof cW/character pairs willlbe 
performed. Each block becomes one record 
in the host file withi SEND; With RECEIVE 
the blocks are concatenated into a single 
string of data. 


NOREPLACE indicates that if a file with the 
same name already exists, it is not to be 
replaced by the new file. {NOREPLACE,, 
rather than REPLACE,.is the. default.) 

Select the language in which the file 
transfer messages sent to the PG session are 
to be displayed, nn is the suffix of the 
message module (INWPMSnn).. 

Indicates that this is a private file accessible 
only by the originator. 

Specify public if you wishito make the file 
available to everyone on the system; 

Specify replace if you want to replace ani 
existing file. 

The file is stored in/received from: a GIGS 
temporary storage queue. 

Use this option only if it is necessary to not 
use Stnrctured Fields. 

Specifies Structured Field File Transfer. 

This option is only valid in; the DFT 
environment. It is required only once for a 
bisync-connected controller where the 
mainframe has not senta Query prior to 
using SEND or RECEIVE. 
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/D 

(Send only) 


With this option) your send command line 
waits 10 seconds before it is sent to the 
host. This option is helpful if you want to 
send a file to the mainframe, but the 
mainframe is not ready to receive the file. 


How to Transfer Files with PS/CICS 

This section explains how to transfer files to and from the 
mainframe using PS/GIGS. PS/GIGS stands for Personal 
Services / Gustomer Information) Control System (formerly 
known as PS/370). Unlike MVS/TSO or VM/CMS,,it does 
not work with IN1D$FILE Send/Receive> an^IBM program. 

Instead, PS/CICS works with an IBM PC program called 
Transfer (DISOSS) to transfer files. Through its menu-driven 
program, you can transfer files between the PC and the 
mainframe. 

The Transfer program must be loaded before EXTiM/ can 
transfer files with PS/GIGS. This section describes the 
different ways to load Transfer and also explains how to 
start file transfer with PS/GIGS. 


What's 
Required for 
File Transfer 
with 

PS/CICS 


Before you try to run) file transfer with PS/GIGS, make sure 
the follbwing conditions are met; 

• PS/CIGS resident; Make sure that:PS/GIGS is resident 
on your mainframe computer. 


• Terminals oni DISOSS network; Make sure the 

terminals doing the sending and receiving are active on 
the DISOSS network. If you are not sure, ask your 
System Administrator. 


J 
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Setting Up 
the Transfer 
Program 


• Load^Transfer: The Transfer prograniimust be loaded. 
Loading Transfer is described inmore detail! in the next 
section. 

• Choose defaults: You must choose the proper defaults 
withihiPS/CICS.. Make sure you understand! the 
options available and the type of file you are 

transferring before using the transfer Gommandi 

Consult your PS/GICS documentation or your System; 
Administrator for more informatibn. 

• DPT mode: You must be in DFT mode. 

• Extended Data Stream: Make sure that your System 
Administrator has configured your mainfirame session, 
for Extended Data Stream and for Structured Field 
Processing "Enabled:" 


There are two ways to set up the Transfer program: It can be 
automatically loaded or manually loaded. To setup 
Transfer so that it automatically loads, select "Transfer" from 
within the EXTPA.' Configurator. To manually load 
Transfer, simply type the transfer command line after your 
PC Session's DOS prompt. (Bbth of these processes are 
explained in more detail later in this sections) 

When Transfer is automatically loaded, your files are 
transferred in 'background mode," whichmeans that your 
PC session can be freed up to run other programs and tackle 
other tasks, besides transferring files. 
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When Transfer is manually loaded, your files can be 
transferred either in either "background mode" or in 
"foreground mode." Foreground mode means your PC 
session is in use and cannot be used for other tasks. If you 
prefer "background mode," simply add a /r to the end of the 
command line that you type after the prompt. 


Automatically Loading Transfer 

To set up Transfer so that it automatically loads when you 

startup EXTiM.^ follow the instructions below: 

1 Exitfrom EXTRA/. 

2 Refer to Chapter 3 of the E>:fra/ Extended Setup and 
Reference Manual to display the Configurator's "Startup" 
menu. From that menu> select "Transfer." 

3 Select a mainframe session where the "Transfer" will 
occur. Next time you start EXTRA/, it will 
automatically load Transfer into the mainfirame session 
that you specify. 

4 Once loaded, simply jump to the appropriate window 
and start the file transfer with PS/GICS. 

Transfer is described in more detail in Chapter 3 of the Extra! 

Extended Setup and Reference Manual. 

If EXTRA/ is not set up to automatically load Transfer, you 

must load it manually. Manually loading EXTRA/ for file 

transfer is described in the next section. 



[ 


Manually Loading Transfer 

Use the following instructions to manually load load 

from the DOS prompt) the Transfer program* 

1 Jump to your PC window. 

2 Make sure you are in the DOS subdirectory that 
contains the EXTRA! program. If the program is on a 
diskette, insert it ini Drive A> and make sure that drive is 
the current' drive. 


) If you prefer 
’‘background mode," 
simply add a/r to the end 
of the command Ifrte. For 
example: 


If the EXTjRA/ program is on your hard disk, make sure 
you are in the hard disk directory that contains your 
EXTRA/ files. (For example, c:\exfra \) 

3 At the DOS prompt, type the Transfer command and 
the letter (short name) of the mainframe session where 
PS/GIGS will be running. For example: 


transfer x/f (Enter] 

transfer X [Enter] 


where af is the short name of the mainframe sessioni 


The Transfer programds now loaded and you; are ready 
to tell PS/GICS to transfer filOs between your PC 
session and the mainframe sessioni After Transfer is 
loaded, you will see a message in your PC session 
indicating the file transfer programds waiting for work. 

4 Jump to the mainframe window and log onto PS/GICS. 
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' Transfer occupies 
appfoxlrmtely l3Kof your 
PC memory. 


After starting PS/CICS, make any necessary changes in 
the defaults. If necessary, enlarge the mainframe 
window. 


IMPORTANT: Startup on PS/CIES can vary widely 
depending on your operating environment. Consult 
your System Administrator for specific PS/CICS startup 
information and for instructions on accessing the 
PS/ GICS Import/ Export menui 


6 Import or export a document as desired; 


Exporting Youcantake a document that is inyour PS/CICS file cabinet 

FiloS from or imbasket and export it to your PC. Once the file is loaded 

PS/CICS to on your PC disk, you can use any PC software available to 

You r PC work directly with the file. 

You can export the following: 

• Editable documents and notes 

• Image documents 

• RP (Revisable Format) text documents 

• FF (Finali Form) text documents 


• PC file documents 

You cannot export references to external documents or 
messages. 

When you export an editable documentor a note, itbecomes 
an FF text document. It remains in FF text when you 
transfer it back to PS/GICS. For more informatiOnon FF text 
and RF text documents, refer to your PS/CICS 
documentatiom 
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To export a document from.PS/GICS to your PG, you need 

to know: 

• The name of the document you ^ are exporting 

• The destination drive 

• Thepathname 

• The file name and extension you want it to have after it 
is transferred to your PG 


Importing 
Files from 
Your PC to 
PS/CICS 


When you import files fromiyour PG to your PS/GIGS file 
cabinet you can^send them tb other PS/GICS users or store 
them in the DISOSS library. 

To import a file from your PG to PS/GIGS, you; need to 
know: 


• Which PG disk drive the file is on 

• The PG filename and extension 

• The filename you want it; to have in PS/ GIGS 


For more information; refer to your PS/GICS 
documentation. 
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File Transfer Status and Error Messages 

If Transfer is loaded in the Foi^ground> during a file 
transfer^ messages willi appear in the PC window. The 
messages indicate the number of characters transmitted, 
errors, etc. 


If Transfer is loaded with the "/r” option, type the following 
to display the status of the transfer: 

[Ctrl/Alt] [Z] [T] 

When an error occurs, the transfer is usually stopped and 
the mainframe session is returned to the READY mode. 
Gertaini types of errors can be detected by using DOS batch 
files to detect an ’’Error Level." For more information; refer 
to your DOS manual! If possible, correct the errors and 
restart the transfer. 
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Support for the DOS Path Command 


EXTJM/'s path command feature allows you: to run £Xril<4/ 
from any DOS directory on the PC, simply by typing extra. 
The pathi command tells DOS to search specified directories 
for commands or batch files that'were not found by a search 
of the Gurrenti directory. 

Support for the path commandi means you; can'transfer files 
to and from the mainframe, regardless ofthe Gurrent 
directory. For example, you may be in the "Sales" directory. 
Instead of changing to the EXTIM/ directory, you; cam simply 
type the foreground file transfer command at the DOS 
promptto initiate a file transfer. The files will then be sent 
from; or received into; the current directoiy. 


1 
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EXTRAf^ support 
for the DOS Path 
Command Is Hmtted to 
DOS 3,0 and above. 


The following is an example of a path command that youi or 
your System Administrator camputin your PC's 
AUTOEXEC-BATfUe. 


patH=c:\;c \ dos;c:\sales;c: \ extra 

The example path statement above instructs DOS to search 
the root directory, then the DOS directory, then the sales 
directory, and finally the extra directory for the executable 
command or batch file entered at the DOS prompt. 



5 Using Editor-Based 
File Transfer 


This chapter explains how to nse EXTRA! Extended 's 
Editor-Based File Transfer feature; This method of file 
transfer is called ''Editor-Based!' because it works with 
mainframe line-editing software (TSO and GMS) to transfer 
text files between your PG and the mainfi'ame. Essentially, it 
acts like a very fast typist working at a 3270 terminal. 

The advantage to using this type of file transfer over 
host-based file transfer is that it doesn!t require additional 
mainframe software to transfer text files. The disadvantage 
is thatyou cannot transfer binary files, such as spread sheets, 
graphics and some word processing documents, using this 
method. Italso is slower and lacks the erroi^correction 
routines of host-based file transfer programs. 

For information about host-based file transfer methods, refer 
to Chapter 4. 
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Discussion: CMS and TSO File Transfer 


There am two types of Editor^Based File Transfer: 
Gonversational: Monitor System (GMS) File Transfer and 
Time Sharing Option (TSO) File Transfer. 


Both CMS (GMS XEDIT) and TSO (TSO EDIT) are 
mainframe applications that let you edit text files under the 
mainframe’s operating systemi GMS is used with the VM 
operating system, and TSO is used with the MVS operating 
system; To determine what operating system your 
mainframe uses, ask your System Administrator. 

In addition to editing text files, GMS and TSO can be used to 
transfer files between mainframe sessions. To do this, CMS 
and TSO must be used withiEXTiM.^ and its Editor File 
Transfer feature. This feature provides an easy-to-use file 
transfer interface that allows you to transfer files in the 
background. Transferring in the background means that 
you can jump from a PG session to a mainframe session, 
initiate a file transfer, then return to the PG session to 
continue working while the file transfers. You don^t need to 
load and unload PC applications, or wait for the file transfer 
to complete. Background File Transfer is explained in more 
detaili in Chapter 4. 

Before you can begin transferring files to and from the 
mainframe, check with your System Administrator to be 
sure EXTRA! has been configured for Editor File Transfer (in 
Background File Transfer). This option is available through 
the configurator’s "Startup^' menu. For more information 
about configuring EXTJM.^, refer to the Setup and Reference 
Manual. 



This chapter explains how to use both TSO and CMS to 
transfer files between sessions. The foUbwing terms are 
used in: this chapter: "upload" and "send>" which mean 
moving a file from the PC to the mainframe, andi "download" 
and "receive," which mean moving a file from the mainframe 
to the PC. 


About TSO File Transfer 

If your mainframe session uses the MVS operating system) 
you can use the mainframe editor, TSO EDIT, to transfer a 
text file between the mainframe and your PC. However, you 
must be in TSO command mode (also called a native TSO 
session). You carmot be in any other TSO subsystem; such as 
ISPF. When you are in native TSO; you: see the Ready 
prompt. If you: have any questions aboutTSO and file 
transfer, consult your System Administrator. 


About CMS File Transfer 

If your mainframe session uses the VM operating system, 
you can use the mainframe editor, CMS XEDIT, to transfer a 
text file between the mainframe and your PC. However, you 
mustbe in CMS command mode (also called a native CMS 
session). You cannot be in any other mainframe subsystem. 
When you are im native CMS, you usually see the Ready 
prompt. 

In addition, to being in CMS command mode, you also must 
turn off all'unsolicited CMS messages. These messages may 
interrupt the transfer process unless you respond to them. 
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Turn offi the messages by entering the following command 
onithe command line of your GMS session: 

set wjsg ojSf [Enter] 

To turm the messages back on> enter on the command line: 
set msgon [Enter] 


Before You Before using EXTlM/'s CMS File Transfer, you must create a 
Begin file that contains the lines of data shown below. To create 

this file; jump to a CMS mainframe session and go into 
XEDIT mode. If you are not sure how to start up and use the 
editor, refer to your CMS dbcumentation or ask your System 
Administrator. 

In XEDIT, create a file withi the filename attachma xedit,. This 
file must contain the following lines of data: 

SET SCALE OFF 
SET NUMBER ON 
SETCURLINEON3 
SET CMDLINE BOTTOM 
SET NULLS ON 
SET PF7 FORWARD^ 

SETPF8TOP 
SET PF9 FILE 
SET PFIO BOTTOM 
SET PFll POWER 
SET CASE MIXED 
SETLINENDON 
SETRECFMV 


XEDIT uses this file when transferring files between the 
mainframe and the PC. 


\ 
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TSO and CMS File Upload 

To transfer a file from the PG to the mainframe using Editor 
File Transfer, follow the steps belbw. These instructions 
apply to both VM/ CMS and MVS /TSQ, since the same 
menus appear for bothi 

1 Jump to a mainframe session and estahlishi either a 
CMS or TSO session. Make sure that you are in the 
correct mode. 




JlfSOW/t/hasboen 

configured exclusively for 
Editor File Transfer, the 
Host FHe Transfer options 
wUI not appear on the 
menu as shown here. 


2 Pfess the keys shown below. Note that: these keys can, 
be pressed from either a PG or mainframe window. 


[Gtrl/Alt][F][T] or WsGM PFIS 


The menu below williappear on your screen:: 


======^^ Pik Iransfep . a 

Characters Transferred i 8 Statiisi: IDLE I 


(kiWMand*: 

PC file: 

Uindow ID:: 

Host Pilfe: 

Options:: 

FILE fl^NSFEH COItlOND 
selections are: 


TtU/D)' TSO Editor (Opldad/lownload) 

C(U^D) ..,, fM Editbr CUplbad/lkMimload} 

T(S/R) ISO Host File Transfer (Senddfeceide)) 

C(S/R^CHS Host Fi le Transfer (Send/Recei ve)) 


t 


ENTER (coRwand)) or <ctrlHenter> to executci <esc> tb pit. 12:^ 1/04/98 











1 


3 At the "Gommand:" prompt, type one of the following: 


TU [Enter] 


CU [Enter] 


If the PC file that 
you are uploading ts 
located In your current disk 
drive and directory, (path), 
you only need to type the 
name of the PC file wrfth Its 
extensions. 


The command field automatically will be updated to 
reflect the full name of the file transfer: TSO EDITOR 
UPLOAD or CMS EDITOR UPLOAD; 

The cursor will advance to the "PC File Specification" 
prompt, as shown below. Type the name of the PC file 
that you would like to upload to the mainframe, 
including the disk drive and-path where the file is 
located, the filename, and its extension/ if any. For 
example: c:\sales\myfile.doc. Press [Enter] after typing 
the filename. 





5 After typing the filename, you will be asked for the 
window name of the mainfiiame sessioniwhere your PG 
file will be sent (A - Z). After typing the short name, 
press [Enter], 


6 After you have entered the session name, you need to 

give your PG file either a ISO Data Set Name or a GMS 
Filfe Name; depending on your mainframe 
environment. The mainframe will store your file under 
this name. 


For TSO, use the format shown: below: 


datasetname [(member)] [/pw] 
where: 




} TSO calls a file a 
(dataset The name of this 
file Is a datasetnama. The 
datasetname is limited to 
44 characters. Mdmber 
and limited to 8 
characters each. 


Valid characters Include all 
alphanumeric characters 
(a- 2 ,0-9); letters are 
shifted to uppercase. You 
may also use three special 
characters ($. #, and @). 
Do not start ^y node of 
the dafasefname {userkJ, 
name, or type) with a 
number (0-9), 


datasetname is a name that identifies the file being 
transferred to the mainframe. This parameter is 
required. 

[(member)] is required if dataset is a partitioned dataset. 
Otherwise, it is not allowed. Your System; 
Administrator may require you; to save your file within 
a partitioned data; set; 

[/piv] is the write-password of the existing TSO dataset, 
if it is write-password-protected. This parameter is 
ignored if the dataset is not write-protected; 
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For example,,a typicalTSO'Data Set Filename would 
appear as follows: 

filel.data(member2)/mypass 

li the datasetname of the file does not begin with your 
userid, you must specify a "fully-qualified 
datasetname'' and enclose the entire dflfasef«ame and 
(member) in apostrophes, as shown below. If the 
dflfasefMflme begins with your userid, you may omit both 
the userid and the apostrophes. To enter a fully- 
qualified cfotesefname with apostrophes, use the format 
shown below: 


'highnode.mme. type[ (member)] '[/pw] 


For GMS, use the format shown below: 


filename filetype [filemode] 


where: 


ifiJjTh© parameters 
shown should be 
separated by blank 
spaces. 

Filsname and Wetype are 
limited to eight characters 
each. Valid characters 
Include all atphanumeric 
characters {a-z, 0-9); 
letters are shifted to 
uppercase. Youmay.also 
use live special characters 
($, #, 0, +, and _) unless 
they are defined as 
terminal control characters 
within your CMS profile. 

Do not use a hyphen 
within your filename. The 
hyphen is a restricted 
character. 


filename is a name that identifies the file being 
transferred to the mainframe; This parameter is 
required. 

filetype is an extensibn to the filename that identifies the 
contents of the file. Bor example data or text. This 
parameter is required. 

[filemode] is an optional parameter that; tells CMS the 
name of the mainframe minidisk where you want the 
file to be stored. This parameter defaults to the "A" 
minidisk. 


For example, a typical CMS Filename would appear as 
follows;; 


pcdoc text A 

7 Alfof the fields on the screen should be filled, except 

the "Options" field. This field williremain blank 
because no options are available with Editor File 
Transfer. If you would like to change any of the fields 
before uploading the file, simply [Tab] to the field and 
update the entry. Be sure to press [Enter] after making 
any changes. 

To start the file transfer, press the keys shown below: 
[Ctrl]/[Enter] 
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8 After pressing [Ctrl]/[Enter],,the File Transfer screen 
will: disappear. You can jump to any window, except 
the mainframe session^ window where your PC file is 
being transferred, and perform other activities. 


You can check on the status of the file transfer at any 
time,,or cancel! the file transfer, by pressing the keys 
shownbelow: 

[Ctrl/Alt] [F] [T] 

The file transfer screen will return, as shown below, 
displaying the status of your file transfer operation and 
the number of characters that have been transferred. It 
also will: ask you if you would like to cancel the 
transfer. To cancel the transfer, type [Y] after the 
prompt and press [Enter]. Type [N] or [Esc] if you 
would like the file transfer to continue. 


. . File fpansfep. 

Characters TransferredJ 12845 Status:: IH PJ«mS 


ConitanarCHS EDIlOB WIM 
FC file: ciSuoriSsariple.doo 
Uindow ID::B 

Host File: sanple text al 
Options: 


w you yisH lo cancel ihe iransfer? 


ENIEH (y or n) 


ENTER (conwand)) or <ctrl)r<enter>>to executci <esc> to pit. 12:28 l/'84/90| 



The "Status:" field can contain any of the following 

messages; 

IDliE This message appears before a file 

transfer activity has begum The 
number of characters transferred will 
be 0: 

IN PROGRESS The file transfer is in progress. You 
can determine how much of the file 
has been transferred by the 
"Characters Transferred:" field.. 

COMPLETE The file transfer is complete. The 

"Characters Transferred:" field shows 
the total number of characters that 
were transferred. 

ABENDED' The file transfer ended abnormally. 

The "Characters Transferred:" field 
shows the total number of characters 
that were transferred'before it 
encountered a problem. An error 
message will appear on the screen. 


9 After the file has been transferred, you'can initiate a 
new file transfer operation by repeating steps 1' through 
8; The fields on the screeni still will contain the entries 
from your last file transfer operation. To change the 
contents of a field, [Tab] to the field'and update the 
entry. Be sure to press [Enter] after making any 
changes so that the old entry is removed and the new 
entry is recorded. 



TSO and CMS File Download 


To transfer a file from the mainfipame to your PC session, 
follow the steps below. These instructions apply to both 
VM/CMS and MVS/TSO; since the same menus appear for 
both. 

1 Establish a CMS or TSO sessiomin any of the mainframe 
windows (A-Z). Make sure that you are in the correct 
mode. 


2 Press the keys shown below. Note that these keys can 
be pressed fromi either a PC or mainframe window, 

[Ctrl/Alt] [P] [T] or WsGtrl PF15 

The File Transfer menu will appear, as shown below. 



543 














3 At the "Gommand:" prompt, type one of the following 
lines:: 

TD [Enter] 

or 

CD [Enter] 

The command field automatically will be updated to 
reflect the full name of the filfe transfer: TSO EDITOR 
DOWNLOAD or GMS EDITOR DOWNLOAD; 


4 Create a PC filename for the mainframe file being 
downloaded. Be sure to include the disk drive and path 
name where the file will be stored; a filename; and any 
extensions. For example-c:\sales\myfile.doc. Press 
[Enter] after typing the filename. 

5 After typing the filename, you will be asked for the 
short name of the mainframe sessibrn where the 
mainframe file is residing (A - Z). After typing the 
window short name, press [Enter]. 

6 After you have entered the window short name, you 
will be asked for the mainframe filename of the file 
being downloaded to your PC session. Enter either a 
CMS File Name or a TSO Data Set Name; depending on 
your mainframe environment. 




For TSO, use the format shown below: 


I ']datasetname[(member)][ '][/pw] 


where: 




j TSO calls a file a 
dataset The name of this 
file Is a dafasefnam©. The 
datasetname ls limited to 
44 characters. Member 
and pwme limited to 8 
characters each. 


datasetname is a name that identifies the file being 

transferred from the mainframe. This parameter is 
required: 

/(■member^] is required if the dataset is in a partitioned 
dataset. Otherwise/it is not allowed. Your System 
Administrator may require you to save yoirr file within 
a partitioned data set. 


[/pw] is the read-password of the existing TSO dataset, 
if it is read^password^protectedi This parameter is 
ijgnored if the dataset is not read-protectedi 

For example, a typical TSO Data Set Filename would 
appear as follows: 

filel.data(memberl)/mypass 

If the datasetname of the file does not begin with your 
userid, you must specify a "fully-qualified 
datasetname" and enclose the entire dafasefname and 
(member) in apostrophes, as shown below. If the 
datasetname begins with your userid, you may omit both 
the userid and the apostrophes. To enter a fully- 
qualified dfltasetnrtme with apostrophes, use the format 
shown below: 


'highnode.name. type[ (member) ] '[/pw ] 


For CMS, use the format shown; below: 

filename filetype [filemode] 
where: 


The parameters 
shown should be 
separated by blank 
spaces. 

Filename and fitetype are 
limited to eight characters 
each. Valid characters 
include all alphanumeric 
characters {a«z, 0-9); 
letters are shifted to 
uppercase. You may also 
use five special characters 
($, #, +< and _) unless 

they are defbiad as 
terminal control characters 
vriftiin your CMS profile. 

Do not use a hyphen 
within your flfename. The 
hyphen Is a restricted 
character. 


filename is a name that identifies the file being 
transferred to the PG session; This parameter is 
required. 

fileiype is an extension to the filfename that identifies the 
contents of the file. Bor example data or text. This 
parameter is required; 

[filemode / is an optional parameter that tells CMS the 
name of the mainframe minidisk where the file is 
located; This parameter defaults to the "A" minidisk. 


For example, a typical GMS File Name would appear as 
follows: 


pcdoc text A 


7 Alliof the fields on the screen should be filled, except 
the "Options" field. This field will remain blank 
because no options are available with Editor File 
Transfer. If you would like to change any of the fields 
before downloading the file, simply [Tab] to the field 
and update the entry. Be sure to press [Enter] after 
making any changes. 


To start the file transfer, press the keys shown'below: 


[Ctrl] / [Enter] 
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8 After pressing [Ctrl]/ [Enter], the Filfe Transfer screen 
will disappear. You can Jump to any window, except 
the mainframe session that contains the file being 
downlbaded, and perform other activities. 

You can check oni the status of the file transfer atany 
time, or cancel the file transfer, by pressing the keys 
shownbelow: 

[Ctrl/Alt] [F] [T] 

The file transfer screemwillreturn; displaying the status 
of your file transfer operation and the number of 
characters thathave been transferred. It also will ask 
you if you would like to cancel the transfer. To cancel 
the transfer, type [Y] after the prompt and press [Enter], 
Type [N] or [Esc] if you would like the file transfer to 
continue. 

The "Status:" field can contain any of the following 
messages: 

IDLE This message appears before a file 

transfer activity has begun. The 
number of characters transferred will 
beO: 

IN PROGRESS The file transfer is in progress. You 
can determine how much of the file 
has been transferred by the 
"Characters Transferred:" field. 

COMPLETE The filfe transfer is complfete. The 

"Characters Transferred:" field shows 
the total number of characters that 
were transferred. 
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Editor-Based File Transfer 


ABENDED The file transfer endedi abnormally. 

The "Characters Transferred:" field 
shows the total number of characters 
that were transferrid before it 
encountered a problem. Ani error 
message will: appear on; the screen. 

9 After the file has been transferred; you can initiate a 

new file transfer operation by repeating steps 1 through 
8; The fields on the screenistilllwillicontaihithe entries 
fi'om your last file transfer operation; To change the 
contents of a field, [Tab] to the field and update the 
entry. Be sure to press [Enter] after making any 
changes so thatthe old entry is removed and the new 
entry is recorded. 


To Cancel 
Editor File 
Transfer 


If you have not yet sent the file with, the [Ctrl] / [Enter] 
command, you can; exit the File Transfer menu by pressing 
[Esc]. To cancel the file transfer after pressing [Ctrl]/ [Enter], 
follow the instructions provided inistep 8, shown previously. 
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File Transfer Tips 


• EXTRA! lets you transfer two files simultaneously by 
running a Background File Transfer in one session and 
a Foreground File Transfer in another. You cannot, 
however, run two Background File Transfers 
simultaneously. (Foreground File Transfer is only 
applicable to Host File Transfer since Editor File 
Transfer does not allow you to transfer files in the 
foregrounds) Both Background and Foreground File 
Transfer are explained at the beginning of Chapter 4. 

• Do not type anything into the mainframe window 
which is engaged in a file transfer unless you are 
responding to a specific system message. Typing into 
this window can cause the file transfer to fail. 



• For best results, the file size of the data being 

transferred should be less than lOOK. Files greater than 
lOOK take a long time to transfer. The line length 
should be less than 255 columns imCMS or 252 columns 
ini TSO while uploading and 245 columns while 
downloading. If your file is larger than lOOK, you may 
wantto use IBM's IND$FILE Send/Receive program, 
which EXTRA.l fully supports. This method of file 
transfer is explained in Chapter 4. 


• TSQ and CMS use an editor to uplbad and download 
files in much the same way thatyou would send a file. 
After you have entered a host filename; EXTRA! 
instructs the editor to create a new mainframe text file. 
The program them places the editor in input mode and 
transmits the data from the PC file to the mainframe as 
lines of inputk When the last PC line has been 
transmitted; the file is saved and the editor exits. 
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Whemdownloadihg, EXTRA/ calls the editor and 
instructs it to list the mainframe file im a mainframe 
window. The program then reads this information 
from the screen! and places it imthe PG file. When all of 
the data ini the mainframe file has been; displayed, 
EXTRA! stops using the editor and closes the PC file. 


• Your textfile is sent to the 
mainframe as a large record. 

TSG limits the record length to 
251 characters, therefore 
records longer than 251 
characters will be split, with; 
the characters after 251 forming a new record. For some 
file types, TSO may limit the record length to 80 
characters, causing the record splits to occur after every 
80 characters. 


Record* A record is a 
related group of fields and a 
field is a related group of 
characters, such as your 
name or social security 
number. 


m If you specify a CMS filename that ali^eady exists on the 
mainframe, your PG file will be appended or added to 
the end of the existing CMS file. 


To learn about other file transfer methods, refer to Chapter 4, 
’’Using Host-Based File Transfer.” 
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Appendix A 

LAN and SDLC Startup 

Conditions 


Xhis appendix describes some of the screens you will see if 
you are connected to the mainframe through: any of the 
methods shown belbw: 

• LAN (Ibcal area network) using a gateway connectibn 

• Remote connection with SDLG (s)mchronous data link 
control) 

• Remote connection with Autolihk/SDLC 

If your PG is connected through any of these methods, read 
this appendix, then return: to Chapter 2 to learn how to use 
all of EXTRA! Extended's features. If you have a coax or 
direct tokeurrihg (also called DLG/DPT) coimection to the 
mainframe, go directly to Ghapter 2. And i£ you?re not sure 
what type of connection you have, ask your System 
Administrator. 
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a LAN Connection 


If your PG has a LAN (Local Area Network) connection; it 
means that several PCs in your office are linked together on 
a network, and the network is connected to the mainframe. 

To start EXTRA.! Extended on a I,AN PG,iollow the 
instructions provided iniGhapter 2, "Using Extra! Extended." 
After starting EXTiM/, you can check on the status of your 
fourmainhrame sessions by pressing [Ctrl/Alt] [Z][L]. These 
keystrokes cause the follbwing menu to appear:. 


EXIRAt Extended 
Release 2.66 


(c) Copyright AttachPiatte Corp. 1983-1990 
All Rights ReserweA 

Licen^d Hater lali- Frogi^ Property of Aitachnate 


Window liflpe 
B t 

c r 

D f 

E P 


— LU AND CAmttP ASSISNHE 

Protocol Station Kane 

Gateway Nane 

LU 

ATN 

GRAND CENIRAL 

ATHQATE 

002 

ATH 

GRAND CENTRAL 

ATHGATE 

0^ 

ATN 

GRAND CENTRAL 

AimATE 

004 

I8N 

SIAIIDN CHE 

IBHGATE 

m 


12:44 l/a4/90A 


Here are descriptions of the fields on this screen: 


WihdiBw: Provides the short name of themainframe session 
window. 


Type: Identifies the type of session, either a [T] for terminal 
or a [P] for printer. 
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Frotooolt Tells whether a mainframe session is 
communicating with the mainframe through' an IBM or 
Attachmate (ATM) protocol!. 

Station Name: The name of the workstation'(PG/Terminal) 
accessing the mainframe; 

Gateway Name: The name of the gateway that the session is 
using to communicate with the mainframe; A gateway 
basically is a PG that emulates a 3X74 GontroUfer. 

LU: Provides the address or Logical Unit (LU) that the 
gateway uses to identify the mainframe session; 


After viewing the "LU and Gateway Assignments" screen, 
you can return; to your previous screen by pressing any key. 
If you would like to jump to a new session, press the 
following keys; 

[Gtrl/ Alt] [Spacebar] or Jump 


Sslecting a when extra.' was configured, the "Keyboard Override" 
New option may have been selected. This option'can be selected 

Resource from the Gonfigurator's "Gonnection" menu; Keyboard 

Override allows you to change resources at startup. 


When you start up, you may want to access a resource that is 
differentfrom the one assigned to you; This is especially 
helpful if your assigned resource is busy. For example, let's 
say thatyou're customized for the resource "sales," but that 
resource is not available at the moment. You can select a 
new resourGe,"inventoiy," and run aniinventoiy application 
while waiting for "sales" to become available; 
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To select a new resource, follbw the steps below: 


/ If your PC Is 
connected via LAN^ you 
can turn mainframe 
sessions on and off 
individually, 


1 Check to see if your mainframe session is turned off. 
The Operator Information Area, located at the bottom 
of your screen, displays the "Terminal Session Off" 
message if your session is turned off. 

2 If your mainframe session is on> use the session; "on" 
and "off" command, shown; below, to turn the session 
off: 


However, if you have a 
remote SDLC connection, 
the "off" command turns all 
your mainframe sessions 
off and disconnects the PC 
from the mainframe. 

When you use the same 
command to turn them 
back on, you must 
reestablish the 
connections with the same 
procedure you used when 
you started EXTRAt, 


[Ctrl/Alt] [O] or WsCtrl Reset 


The session'"on" and "off" command is discussed in 
more detail; in Chapter 2. 

3 After the session is turned off, press [Ctrl/Alt] [O] or 
WsGtrl Reset once again to display a screen like the 
sample below:; 


============= KEqUESIED RESOUJCE -- ,| 

Current resource nane: SALES 
Net! resource nane: INUENTOKV 

14 :S 6 mm 


4 


At this screen, you can either type the name of a new 
resource and press [Enter], or press [Enter] by itself to 
keep your current resource. 




Remote Connection with SDLC 


SDLC (S 3 mchronous data link control) is an adapter that fits 
inside your PG. It allows your PC to communicate with a 
remote mainframe through phone lines using an external 
modem. With an SDLC connection, a modem dials your 
desired mainframe, allowing your PG to access the 
mainframe. This type of connection is different from a 
Autolihk/SDLC connection. Autolihk is an SDLC adapter 
that has a modem and automatic dialer on-board. It, too, fits 
into your PC. The procedures for using an Autolihk/SDLC 
eonnectiomare described on page A-7. 


Using Extra! 
with an 
SDLC 

Connection 


To start EXTRA! with an SDLC connection, make sure that 
EXTRA! is configured for SDLC, and that your PC meets all 
the requirements of your remote host (mainframe). You 
should be using an external diahup synchronous modem. 
Consult your System Administrator if you have any 
questions. 


Once your PG is properly configured, you can begin using 
EXTRA! by following the steps below: 


1 Type extra after your PC's DOS prompt and press 
[Enter]. If you're not in a mainframe session, jump to 
one by pressing the following keys: 


[Ctrl/Alt] [Spacebar] or Jump 


2 The Network Connection Menu> showni below, contains 

the names and telephone numbers of the mainframes 
your System Administrator has selected. If you see this 
menu after starting EXTilA/, decide which mainframe 

telephone number you want, then skip to Step 4. 


=HBttfBrk Connection (lenu= 


« 1. Inventory database 83263948455 


2. Corporate host 166283847 

3. Sales database 28347758953 

ENTER (selection) 


WlthanSDLC 


otnnec^ion, the session 
*on" command turns all of 
your mainframe sessions 
on, not just your current 
active session. YOuwHI 
need to reestablish the 
connection by following 
the same procedures as 
when you started EXrmi 


3 If you do not see the Network Connection Menu, turn 
the mainframe sessiom "on” by pressing: 

[Ctrl/ Alt] [0] or WsCtrl Reset 

Once the Network Connection Menu appears, select the 
mainframe telephone number you want 

4 Switchi the modem setting to "Talk," and dial the 
number as showniin the menu: 


5 The mainframe modem wilt generate a tone. When you 
hear the tone, switch the modem'setting to "Data." 

Now hang up your handset and press [Esc]. 

6 From the mainframe session, you can begin using your 
"3270 terminal." 
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Remote Connection with Autolink/SDLC 


Autolihk is an integrated SIDLG adapter that includes a 
modem and automatic dialer on a card that fits inside your 
PC. 

Before you can begin using EXTIM/ with this type of 
connection; make sure that EXTRA! is configured for 
Autolink/SDEC and thatyour PC meets all the requirements 
of your remote host (mainframe). Consult your System 
Administrator ifyou have any questions. 

For Autolink to function; your terminal! must be turned on 
automatically wheni EXTiM.' starts up; (Refer to "Terminal 
On/Off" in the next section.) 


Using Extra! 
with an 
Autolink/ 
SDLC 

Connection 


EXTRA/ offers several Autolink/SDLC options: Terminal 
On/ Off, Auto*Dial/Disconnect, and Keyboard Override. 
The condition of your system at startup and the actions you 
take to diahup depend oni which combination of these 
options your System Administrator selected during 
customization; 


Temiinal! On/Ofih This option is selected on the 
Configurator's "Startup" menu. It controls whether or not 
the terminal is turned on automatically when EXTRA/ is 
loaded. If you use more than one mainframe session, it is 
recommended that you choose Terminal Off; otherwise 
every time you start EXTRA,', the first number on the 
Network Connection ; Menu will be automatically dialed. 



HExrmm not 
configurid for Terminal 
On, the setting of the Auto- 
Diaf/Disconnect option has 
no affect on AutofInk. 


AutdfDial/Disconnect: This is a Setup Modenvi option on 
the Configurator's "Connection!' menui It is chosen when 
modem parameters are selected for your Autolink/SDLC 
connectibni 


If Y (yes) is selected and your system is configured for 
Terminal On, the gateway or PC automatically establishes 
communications with the mainframe when your session 
request is initiated. It also re-establishes communications if 
the line goes down. 

If N (no) is selected, the gateway or stand-alone will not 
automatically connect and disconnect communications with 
the mainframe. 


Keyboard Override: This is a Setup Communications 
optiomon the Configurator's "Connection'' menu. The 
default selection for this option is N (no)i 


J The Keyboard 
Override does not apply If 
your to'minal is on at 
startup and you are 
configured for Auto- 
Dlaf/Dlsconnect. 


Under Conditions 2 and 3 described below, you establish a 
connection by selecting a phone number from the Network 
Connection Menui If the Keyboard Override option is set to 
Y (yes)/ you can change the phone numbers on the Network 
Connection! Menu or use a number that is noton themenui 


If Keyboard Override is not selected, you may select any of 
the phone numbers on the Network Connection Menu. 

The condition of your system when you start EXTRA/ 
depends on your configuration. To establish a connection, 
refer to the instructions for your system's startup condition, 
as described in the pages thatfollOw. 



Condition 1: Terminal* On « Auto^Dial/Disconnect On 




J Once your 
connection has completed 
{or fallec^, you can 
disconnect and change the 
phone number, If 
necessary, by turning a 
terminal off, and back on, 
then selecting the 
appropriate name from the 
menu. 


When EXTRA!: starts, the first mainframe telephone 
number (#1 onyour Network ConnectibniMenu) is 
dialed automatiGally. You do not need to take any 
action. 

The Network Connection Menu appears, as shown 
below, and the message "AUTODIAL IN PROGRESS..." 
displays as the connection: is being established. 


.. Netnork Coraectibn ltenu= 

■» 1. Inuentory database 83203948455 

1 . Corporate host 100283847 

3. Sales database 28347758953 

AUTODIAL IH FROCRESS... 


• Conditioni2: Terminal On - Auto*Dial/Di8connect Off 


At startup, the Network Connection Menu: appears. At 
the bottom of the menu youi see the message: "ENTER 
(selection)." 


Select and enter the number (1,2, or 3) of the 
appropriate name on: the menu. 


If you selected Keyboard Override in customization, 
you can enter a mainframe telephone number not listed 
on the menu or you can: change a listed number. 

Follow the instructions that appear on the screen; 



• ConditioniS*; TerminaliOff (Auto^Dial/Disconnect Oni 

or Off): 

Jump to a mainframe session window by pressing: 

[Ctrl /Alt] [Spacebar] or Jump 
Turn the terminal on by pressing: 


[Ctrl/Alt][0] or WsCtrl Reset 

The Network Connection Menu appears. At the bottom 
of the menu you see the message: "ENTER (selection)." 

Select and enter the number (1,2, or 3) of the 
appropriate name on the menui 

If you selected Keyboard Override in customization 
you can enter a mainframe number not listed on the 
menu or you can change a listed number. Follow the 
instructions that appear on the screen; 


The table below summarizes the conditions described; above: 


Terminal AutoDiai Action 


1 On On None; Number dialed 

automatically; 

2 On Off: Enter selection. Number is then 

dialed. 

3 Off On or Off Go to mainframe window. Turn on 

terminal. Enter selection. Number 
is then dialed. 
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Error Messages in SDLC or Autolink/SDLC 

You may encounter an error message while trying to make a 
connection using SDLG or Autolihk/SDLG. A typical 
message would be "ERROR 42 BUSY SIGNAL" or "ERROR 
4E NO ANSWER;" 

Error codes 40*592 If you receive an error code in this range, 
try to make the connection again. If you still can't make the 
connection) consult your System) Admirustrator. 

Other error codes: If you receive any other error code, 
consult your System Administrator. 
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Glossary 


Adapter. A hardware device or "board" that is located 
within your PC and gives your PC additional! capabilities, 
such as the ability to communicate with a eontrollfer, 
mainframe or other device. 

Algorithm! A statement of the steps to be foUbwed in 
performing a task or solving a problem; Id a computer 
program; the steps of an algorithm! are specified in a specific 
computer language. 


Altkey. Key on PC keyboard that has no function when 
used alone, butis used to modify the function: of another 
key. It is often used to control special 3270 functions such as 
terminal off / on, help, etc. 

Application! program! The instructions to a computer to 
accomplish processing tasks for a user. 

APIl Application Program Ihterface. A programming 
interface to the 3270 emulation program thatallows a PC 
application program to simulate the keystrokes of a human 
operator and communiGatedirectly vrithithe mainframe. 


ASCII. American Standard Code for Information 
Interchange. A 7-bit code,developed by the American 
National Standards Institute committee, for the exchange of 
information between communication devices. ASCII is used 
primarily in asynchronous communications. 

Asynchronous. A transmission scheme that uses start/stop 
bits to define a character and separate it from other 
characters. (Compare si/«c/irono«s transmission.) 



AUTOEXECBAT, A special BWch file that is executed 
automatically when the PC is turned on> or rebootedl It can 
be used to automatically start application I pmgrams or 3270 
emulation. 

Backup diskette. A diskette containing information copied 
from a fixed disk or from another diskette. It is used in case 
the original information becomes unusable. 


Batchi The processing of data that has accumulated over 
time. {€ompam interactive). 

6aud4 A unit of measurement that indicates the electrical 
change from 0 to 1 across an electricaliinterface Baud is a 
termioftemmisused in describing data transmissiomrate, 
which should more accurately be expressed in ibits per 
second (bps)* 

Binary File. A file that contains information! that has been ' 

stored in the computer ina binary format. Binary is a « 

notation system based on the number 2) it uses only two ' 

integers, 0 and 1. Typical binary files include spreadsheets, [ 

graphics, some word-processing documents, or a file that 
has a .COM or .EXE extension; ( 

Bisynchronous (Bisync, BSG, or bihaiy synchronous [ 

communication). A character-oriented, half-duplex data ^ 

communications protocol; Bisync is the older of IBM's two ^ 

transmission schemes for its mainframe computers and is , 

currently being replaced by SNA/SDEC. ^ 

Biti Shortfor "binary digit-'. The smallest unit of ^ 

information expressed in distal form!as "0" or "I". [ 

Block. A sequence of characters or bytes transmitted as a [ 

unit 
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Boot. To load the operating system! software (DOS) into a 
PG. When a PC is turned on with DOS in one of the disk 
drives, the PG automatiGally searches for, finds and loads the 
disk operating system (DOS)j When a prompt(A:, B:, or G:) 
appears, the operating system has been booted or loaded. 

bps. Bits per second, a measurement of data transmission 
speed. 

Buffer. A storage medium used for holding data until that 
data can be transmitted to another device. 

Byte. A group of 8 bits whose sequence represents one 
character. 

Channel; A path for the transmission of information. On a 
mainframe, the channel is a highrspeed interface to 
communications devices such-as a 3X74 Control Unitor a 
37XX Communications Controller. 

Character. A single unit of meaningfuli data, such as letters 
and numbers. 

eiCS. Communications Information Control System. A 
mainframe database application that offers limited relational 
functions but quick response time. 

Circuit; A communications path betweeni two points. 

Cluster; Several pieces of data terminal equipment, usually 
personal computers or intelliigent terminals, arranged in 
close proximity to enable cabling between them; A grouping 
of terminals or processors connected to a common computer 
or Gommunication device, such as a 3X74 Control Unit. 

CMS. Conversational Monitor System. An interactive 
mainframe system than resides under the YM operating 
system; Provides editing and file management functions. 



Coax adapter. A drcuit board that provides a 3270 interface 
between a device, such as a PC or a controller, anda coaxial 
cable. 


Coaxial cable. A transmission cable with one central 
conductor within an outer conductor of copper tubing that 
actsas an insulator. Used for connecting 3270 terminals and 
processors for high speed communication purposes and 
offering high immunity to electrical interference and a low 
incidence of errors. 

Code; A set of rules that determine how characters may be 
represented; (See ASCJJ and EBCDIC).. 

Communication link. See Data link 

Compatible. Pertaining to computers on which the same 
computer programs can run withouti appreciable alteration. 

Concurrency. Enables PC programs to runi concurrent with 
3270 mainframe functions even if the PC window is not 
selected; 

Configuration; The selection of various options to 
customize a software program for use in a; specific 
environment. 

Configuration tile. A DOS file that specifies the 
characteristics of a system or subsystem; 

CONFIG.SYS. The PC startup configuration file. 


Controller. A device, suchias a 3X74 Control Unit> that acts 
as the'electrical and logical interface betweeni several display 
terminals and/or printers and the host processor oma 
network. 



Control program^ The set of functions in the 3270 emulation 
program that maintains communications with the 
mainframe and allows other functions such as window 
management; file transfer and printer emulationi 


Controli Unit Terminal (GUT): A 3X74 operational mode 
designedTor nondntelligenti terminals that allows one 
mainframe session* 

Cooperative processing; Processing that allows two 
applications to communicate on a peer basis. 

CMS router. A program running under VM/SP that uses 
the Server-Requester Programming Interface (SRPI) to route 
requests from the PC to the corresponding server on the 
mainframe. The CMS router is part of the CMSSER^ 
command processor in VM/SP Release 4; 

Current Drive. The disk drive the PC is currently accessing. 

CUT. See Control Unit Terminal. 

Data communications. The transmission of data over 
electronic communication links between a computer system 
and a number of terminals at some distance away from the 
computer. 

Data Communications Equipment (DCE):, Equipment, such 
as a modem or controller, that provides the functions 
requiredi to establish, maintain: and terminate connections, 
conversions, and coding for communications between data 
terminal equipment (DTE). 

Data compression; The process of reducing the length of 
records or data by eliminating gaps and redundancy. 

Data link. The equipment and rules (protocols) used for 
sending and receiving data. 




Data Link Control (DLC). The native protocol of the IBM 
token^ring card. 

Data set The major unit of data storage and retrieval 
consisting of a coUectioni of data ihione of severali prescribed 
arrangements and described by control information to which 
the system has access. 

Data stream^ All the data transmitted over a communication 
facility during a single operationi 

Dato Terminal Eqviipment (DTE)^ Any device,, such as a 
computer, terminal or printer, that acts as an origin of, or a 
destination for, data. 

Data transformationi The translation of file formats from 
one file structure to another in order to achieve logical 
interconnection across a network. 

DCA. See Document Control Architecture, 

Dedibatedi lines. Private circuitis between, two or more 
stations, switches, or subscribers. 

Default!. A value that is used^ when nothing is specified by 
the user. 

DPT. See Distributed Function Terminal 

Diagnostics. Special software routines that identify 
malfunctions. 

Dialup^ Access to a switched network, usually through a 
dial or push-button telephone. 

DISOSS. See Distributed Office Support System, 



Distributed Functional Temiinal (DPT); (1) An operational 
mode that allbws multiple concurrent logical terminal 
sessions. Contrast with ConfroZ Unit Terminal (CUT). (2) A 
hardware/software protocol!used to communicate between 
a terminal and a 3X74 control uniti 


Distributed Office Support System (DISOSS). An IBM 
mainframe*based system for the translation; exchange, and 
routing of informationi DISOSS is based on a store-and- 
forward technique. 

Document Control Architecture (DCA)i An IBM 
application that defines the formi and content of office 
systems documents that are interchanged through an SNA 
network. 


Document interchange: The ability to transfer documents in 
both final and editable form over the network, regardless of 
the word processors used. 


Document Interchange Architecture (DIA)l An IBM 
application that defines the way in which requests and 
documents can be transferred through an SNA network 

DOS. Disk Operating System; a group of programs that 
enables a personal computer to organize and use 
information on diskettes or fixed disks, including application 
programs. 

DOS Prompt: A letter, followed by the > character, 
displayed by DOS to indicate that it is ready to process 
commands from the standard input device (usually the 
keyboard). 


Downloading. Transferring a file from! a mainframe to an 
IBMPG. 


Drive specification: Ih DOS; the letter-colon pair that 
specifies a drive; 


DTE., See Data Terminal Equipment. 

Dumb temiinal; A terminal; connected to a mainframe, that 
can send‘ and receive informatibn but has no processing 
capabilities of its owm 

Duplex. A two-way transmission system) synonymous with 
full-duplex, in;which: information can be carried in both 
directions simultaneously. 

EAB. See Extended Attribute Byte. 

EBCDIC. See Extended Binary-Coded Decimal Interchange 
Code. 


EMS. See Expanded Memory Specification. 

Emulation. The process of imitating the functions of another 
system; 

Enhanced Connectivity Facilities (ECF)i A set of programs 
for interconnectihg IBM Personal Computers and IBM 
System/370 mainframe computers operating with the 
MVS/XA or VM/SP environment. 

Enter. To send information to the computer by pressing the 
enter key. 

Error controL The process ofmonitoring data transmissions 
to detect and correct errors. 


Expanded Memoiy Specification; (EMS), A specification 
developed by Lotus, Intel, and Microsoft that allows DOS 
applications,, such;as EXTRA / Extended, to use memory 
normally not available. 

Extended Attribute Byte (EAB), Allows PC to support 3270 
Extended Attributes - Highlighting, Reverse Image, Blinking 
and Seven Colors. 



Extended Binaiy-Coded-Decimal Interchange Code 
(EBCDIC), An S-bit data transmission code developed by 
IBM and used primarily for synchronous communications in 
IBM mainframe and compatible systems. EBCDIC is the 
standard code for large IBM systems. 

Extension^ In DOS, an optional parameter that> if used, 
immediately follbws a filename; Itconsists ofa period and 
1-3 characters. 


FEP. See Front End Processor. 

Fieldi, (1) An area in a record or panel used to contain a 
particular categoiy of data. (2) The smallest component of a 
record that can be referred to by a name. (3) An area in a 
structured file defined in the form used to enter and display 
data. Fields are defined using either text data paths or tree 
data paths. 

File; A coUection of related data that is stored and retrieved 
by an assigned name. 

Filename> DOS. In DOS, that portion of the file name that 
precedes the extension! This form is only for syntax 
descriptions. 

Filename/VM/SP. The first part of a three part label for 
naming files on VM/SP. It canbe up to eight characters long 
and include letters, numbers, and some special characters. 

File transfer. The movement of a complete set of data from 
one computer to another, usually accomplished by dividing 
a file into a series of screens which are then reassembled at 
the receiving end; 

Filefype, VM/SP. The second part of a three part label for 
naming files on VM/SPi It can be up to eight characters long 
and include letters, numbers, and some special characters. 


Fixed diisk. A flatv circular, nonremovable plate with> a 
magnetized surface layer oniwhich data can be stored^by 
magnetic recording. 

Floppy disk. A removable disk (diskette) with a magnetized 
surface layer on whichi data can be stored by magnetic 
recording. 

Formati (1) A defined arrangement of such things as 
characters„fields, and lines, usually used for displays, 
printouts,,or files. (2) The pattern whichidetermines how 
data is recorded; 

Front endi processor (FEP)i A special purpose processor 

programmed to offload the maihft'ame of communications 
functions such I as message handling, codeconversibn) and' 
error control. 

Full-duplex. A two-way transmission system in. whichi 
information can be carried ih both directions 
simultaneously. 

Function keys. (1) Keys that request actions but may not 
display or print characters. Included are the keys that 
normally produce a printed character, but when used with 
another key produce a fimction instead; (2) Oni3270'PC and 
System/370keyboards, these are programifimctiomkeys. 

Gateway, A device that uses protocol conversion to connect 
dissimilar communications systems. The gateway provides 
the translation from one set of protocols to another,, such as a 
localarea network to a mainframe; 

Half-duplex. A sequential, two*way transmission) of data in 
whichiinformation can be transmitted in both directions, but 
only one direction I at a time. {(Homp^iTe full-duplex). 
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Handshaking; Preliminary signal transfer betweeni 
communicating elements to verify that communication has 
beenestablished. 

Hardware. The equipment^ as opposed to the programming, 
of a computer system; 

Hexadecimal. Pertaining to a systemi of numbers to the base 
sixteen; hexadecimal digits range from 0^9 and A (ten) 
through F (fifteen). 


High Level! Language Application. Programi Interface 
(HLLAPI); Provides a high level interface to the 3270 control 
program for PG applications written in Basic, Gobol and 
other high level languages. HLLAPIiallows PG programs to 
communicate directly with the mainframe. 

Host. The computer that provides processing capabilities 
for terminals and other devices attached to it. 

Host computer; The primary and controlling computer in a 
networlg usually provides services such as computation, 
data base access, and advanced programming function. 
Sometimes referred to as a host processor or mainframe. In 
the IBM environment; the host is usually an S/370,9370, 
4300; or 30XX series of computer. 

Host graphics. Graphics images generated on. an IBM 
mainframe computer and displayed or printed on a 3270 
terminal; 

IBM. International Business Machines Gorporation. 


Information utility fries. Gontain information regarding 
Program updates and extended features, detailed technical 
data, troubleshooting, and other general and valuable 
information relating to EXTRA/ Gownectmify Software and its 
environment. 




X-11 



Input device; A physical device used to provide data to a 
computer. 


Intelligent terminal; A terminal or workstation with a built 

in processor capable of Rpndlhcr 


storing data. (Compare dumfe termiml)i 

Interactive; A condition in which an end user has aniopen 
channel to a computer system; permitting an. immediate 
response to a request or inquiry. (Compare bafc/i), 


Interface. The boundary between two systems or devices or 
the logical connection at which two systems cani 
interconnect. Also; a device that provides a logical 
eonnectionbetween different transmission! systems or 
equijpment. 


IRMA. A basic 3270emuletionisystemisupplied by Digital 
Communications Associates, Inc. 


Keyboard; An input device consisting of various keys that 
allow the user to input data, control cursor and pointer 
locations, and control the dialog between i the user and the' 
workstation; 


Kilobyte (KB); l,024 bytes (in common usage, a thousand 
bytes). 


Leased line; A private communications line leased or rented 
from a common! carrier, such as AT&T, or MCI. 


Line speed; The maximum transmission rate over a 
communications channel, usually expressed in bits per 
second. 

Link. A circuit or transmission path, ihdudihg all 
equipment betweenia sender and a receiver on'a network; 
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Local. Pertaining to a device directly connected to your 
systemi without the use of a communication lihe. 

Local area network (LAN); A collfection of many computers 
ih one area connected with wire and usually equijpped with 
some sort of peripherals that the computers share; a 
communications network within a limited physical area such 
as an office building or manufacturing plant The three basic 
components of a LAN are the cards thatplug into the 
computer to connect it to the network; cabling and: networks- 
control hardW^are; and software; 

Logical Unit (LU); The port, or network addressable entity, 
through which) users gaih access to SNA and communicate 
with one another. 

Logo^. A command for ending a mainframe session. 

Logons A command for beginning a mainframe session. 
Mainframe. See Host computer. 

Megabyte (MB); One millibmbytes. 


Menu; A displayed list of items from) which a: user can make 
a selection; 

Micro-mainframe link. A package specifically designed to 
accomplish communication between a PG and a mainframe 
computer. 


Modem; A device that modulates and demodulates signals 
transmitted over a network. It converts computer data 
(digital) into audio signals for transmission) across telephone 
lines. 

Modulation. In data communications, the conversion of a 
digital signal to an analog signal; 



Multiple sessions. More than one SNA sessionrwith an IBM 
mainframe, used to access multiple mainframe applications 
from a single terminal or PG. 

Multiple Virtual Storage (MVS)» The actual name is 
OS/VS2-MVS. It is the primary operating system for large 
IBM and IBM-compatible computers. 

Multiplexerv A device which combines several data 
channels by interweaving the data for transmission over one 
high speed channel. 

Multidrop. A term used to indicate systems in which 
severali points are served by the same circuiti 

NETBIOS. Network Basic Ihput/OutputSystemi Software 
developed by IBM that provides the interface between; the 
PC's operating system, the 1/ O bus, and the local area 
network. Since its design; NETBIOS has become a de facto 
standard; 

Network. A computer communications system linking a 
series of computer elements. A system of interconnected 
computing devices that can communicate and share 
resources. Networks may be private (for use by one 
customer) or shared (for the use of many customers). 

Network management). Software and hardware that enable 
a manager to perform certain; administrative, security, and 
accounting functions in managing the network: reconfigure 
the network topolbgy, download software, monitor network 

performance, maintain departmental billing, and diagnose 
and troubleshoot problems. 

Network server. A node on a local! area network (LAN) that 
is configured to share its resources with the other PGs on the 
LAN. 



Network station^ A 3270 workstation oni a local area 
network (IlAN) that must use a gafeway to communicate 
with a System/370; 


Node. Any device such as a computer, terminal, or 
peripheral that is connected to a communications network. 

Notepad window. An electronic "scratch pad" that provides 
1,920 bytes of ondine text data which can be viewed, 
entered^ saved or edited on PC. Gan be stored or retrieved 
fromiPG disk at any time. 


OIA. See Operator Information Area, 

Operating systemi Software that controls the running of a 
computer system; in addition, an operating system can 
provide services such as resource allocation, scheduling; 
input /output control, and data management 

Operator Information! Area (OIA), The 25th line of all 3270 
terminals, reserved as a status line, displays information in 
text andi symbols about the status of the terminal and the 
application! that is running. 

Operator information! line. A line on your personal 
computer or workstation screen used to display messages 
and status information: This information is normally 
displayed on the last line on the screen. 


Packet size. The size of data units, in kilobytes, used in 
Structured Field file transfer. 

Parallel transmission: A method of information transfer 
whereby the bits composing a character are sent over a 
number of wires at the same time. This form of transmission 
is faster than serial transmission. (Compare serM 
transmission). 



Path* A DOS command used to access files found im 
subdirectories on a hard disk. This command tells DOS to 
search specified directories for commands or batch files that 
were not found by a search of the current directory. 

Peer-to-peer communications. The ability of intelligent 
devices to communicate directly with one another without 
relying on the mainframe. 


Physical Unit (PU); A term used in the SNA environment to 
identify the addresses for printers, terminals,.PCs, and other 
devices on the network. 

Plug compatible; lii microcomputers, a term used to signify 
that a card or board of one computer is compatible with, or 
willifit, the 1/Qbus of another computer. 

Polling* A method of controlling the sequence of 
transmission from multiple devices on a network, whereby 
the controller requests or invites individuali terminals to 
transmit data. Polling enables the controller to manage the 
transmission: of data from multiple devices in an orderly 
manner. 

Port. A point of exit or entry for a data channel ini a 
network, usually found on the/ronf end processor. The point 
at which devices canbe connected to computers or networks 
for. transmitting or receiving data. 

Presentation! space. In the 3270 environment, a region in 
computer memory (either mainframe, or PG) that can be 
displayed, in whole or part, in a window on.the screen; For 
example, a spreadsheet consisting of 4,096 rows and 4,096 
columns is a presentation space that cannot not be viewed in 
its entirety on one screen. However, it canbe viewed in 
sequence, part-by-part.. Sometimes presentatibn space is 
used synonymously with session, although) not all 
presentation! spaces are sessions (technically, some internal 
components are presentation spaces). 



Printer emulation^ A function of the 3270'Conti?oliPl'ogram 
that allbws a printer attached t& the PC or a local area 
netw:ork to appear to the mainframe as a 3287 printer. 

Program; A file containing a set of instructions conforming 
to a particular programming language syntax. 

Proprietary. A term used to denote a system developed and 
supported by one particular vendor. 

Protocol; The set of rules or conventions that define the 
responsibilities and functions of computing devices that will 
enable the effective exchange of information between them. 

Protocol'conversion; The process of translating protocols 
from one computer system to another so that the two 
different systems can communicate. 

PS/370; A mainframe^resident program used to perform 
office automation tasks under DISOSS. 

PS/CIGS. Stands for Personal Services/Customer 
Information Control!System. PS/CICS is a method of 
transferring files between a mainframe and a PC using IBM's 
Distributed Office Support System (DISOSS). 

PS/PC. A PC-resident program used to perform office 
automation'tasks under DISOSS. 

Query. The action of searching data for desired information. 

Queue. A line or list formed by items waiting to be 
processed. 


Record; A collection of fields treated as a unit. 


Requester. The program that relays a request to another 
computer through the Server-Requester Programming 
Interface (SRPI). (Contrast with Seruer.) 


Response time. The amount of time elapsed between the 
generation of an inquiry at a communications termihal and 
receiptof a response at the terminal; Includes transmission 

time, processing time, and contention time between! system 

components. 

Router. Provides a Server-Requester Programming Interface 
(SRPIi)> a request interface for requesters, and a reply 
interface for servers. 

Screen capture. Enables a "snapshot" of an entire window 
screen; Gan save screen images to disk or print oniPG 

printer. 

Screen print; Screen print allows the contents of the screen! 
that is currently displaying to be printed^ at the PC printer. 

SDLC. See Synchronous Data Link Control 

Serial interface. A connection or port that permits serial 
transmission oi data. 

Serial transmission. A method of information! transfer 
whereby the bits comprising a character are sent one at a 
time over a single wire. (Compare parallel transmission). 

Server. A processor thati provides a particular service to the 

network, such as a communication server, file or disk server, 

andi printer server. 

Server, LAN. See Network Server. 

Server-Requester Programming Interface (SRPI). (1) A 
protocol between Requesters and Servers when using 
Enhanced Connectivity Facilities (ECF), (2) A programming 
interface used by requester and server programs to 
communicate withi the PC or mainframe routers. 




Session; A series of conversations or interactions that take 
place between two SNA Logical Units such as a mainframe 
application! and a 3270 display terminal. 


Shared Address. A portion of memory used in reserve DOS. 


SNA. See System Network Architecture. 

Software. Programs, procedures, rultes, and any associated 
documentation pertaining to the operation of a computer 
system. (Contrast withi Hardware.) 

SRPI. See Server-Requester Programming Interface. 

Stert/stop. The first/last bit or element carried in the 
as)mchronous transmission of a character to either 
synchronize the receiver or return the circuit to the at-rest 
position; 

Structured Field; A field is a related group of characters, 
representing some unit of information, such as a person's 
name or social security number. A field usually contains 
severaliGharacters butcan consistof a single character. A 
structured field requires certain informatibnito be placed in 
the field. A structured field also refers to a packet of 
information used to transfer data to and from the host. 

Switched line; A communications link for which the 
physical path can vary depending on the use of the line. 

Synchronous Data Link Control (SDLC). An IBM protocol 
for synchronous communications that operates within SNA. 
A discipline for managing synchronous, code-transparent 
seriahby-bit information transfer over a link connection. 
{Compare withBinary Synchronous Communicatmns.) 


Synchronous transmission^ A transmission! scheme or 
mode of transmitting data whereby the data is sent as blocks 
of characters with controls atthe beginning and end of each 
block that ensure constant timing, or s5mGhionizationi 

System!Network Architecture (SNA), An! IBM proprietary 
plan for the design of a wide area network that includes 
specifications for communication protocols and sessions 
management!. 

Syntax. The rules for the construction of a command or 
program. 

T-1. A technology praviding high speed transmission over 
10ng-distance;Jeased lines (althoughialso available over 

satellite, microwave, and fiber). T-1 lines, used to transmit 
voice and data, operate at 1.544 Mb/s and can be 
multiplexed into 24 individual channels of 64Kb each; 

Text File. A file that contains alphanumeric text in a 
readable format as opposed to numeric text which is not 
readable. A t5^ical text file would be as word*processing file. 

Token! Interface Coupler (TIC); A high-speed interface that 
links a mainframe to a token! ling network. 


Token-Ring; A network with a ring topolOgy that passes 
tokens from! station to station. 

TOKREUL (Token-Ring Extended User Interface) DEC 
hardware drivers for the token-ring cards. 

TSO. Time Sharing Option; An interactive mainframe 
system that resides under the MVS operating system. 
Provides editing and file management functions. 

TTY Teletype; A standard file fonnat for ASCII; 
asynchronous communications, based uponi early Teletype 
devices. 



Uploading; Transferring a filfe from the PG to the 
mainframe; 


User. Anyone who requires the services of a computer 
system; 

Variable; A name used to represent a data item with a value 
that can change while the program is running. 


Virtual disk. A disk that appears to belong to an individual 
user but in fact is shared or available to aUiusers on a 
network. 


VMt Virtual Machine. A mainframeoperating system that 
provides time-sharing functions for several users, but 
appears to each user as a fully dedicated computer system. 

VM/GMS. See CMS. 


Wide Area Network (WAN)i Any network that covers a 
large geographic area (50 miles or more) and may include 
packet-switching, public data, and^ value-added networks. 

Window. A defined area on the PG display which is used to 
present a PG session, a mainframe session, or a Notepad. 

Window layouts. Allows set-up of start-up window 
configurations. It includes the ability to color screens, move 
windows, size windows, etc. 


Workstation; A single-user computer systems designed for 
multiple active functions, such as word processing and 
mainframe access. 
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ABENDED M6 
APL characters 

displaying on mamframe 2-35 
printing 2^36 
Append 

GIGS file fcmnsfar option 4^52 
GMS file send option 4-28 
TSO file receive option 4-45 
ISO file send option 4-39 
Arrow keys 2-26 
ASCni 

GIGS file transfer option 4-52 
GMS file receive option 4^33 
GMS file send option 4-28 
TSO file receive option 4-45 
TSO file send option 4^39. 

Assignments, checking LU and pteway A-3 
Attachma xedit file 5-5 
Auto^Dial/Disconnect A-8 
AUTOEXEGJATfile 4-61 
Autolink 

and Terminal Oh/Off setting A-7 
configurable options A^7 
dialing automatically with > A^7 
error messages A-11 
startup conditions A^IO 
using A-9 

with SDLC connection A-5 
Autolink/SDLG {seQ Autolink) 

B 
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GIGS file transfer option 4-54 
GMS file receive option, 4-33 


(continued) 

GMS file send option 4-29 
TSO file receive option 4-46 
TSO file send option 4-41 
Background file transfer 4-8,5-3 
Backspace key 2-26 
Binary 

GIGS file transfer option 4-52 
files, host-based transfer of 4-1 
Blank, GIGS file transfer option 4-52 
Blksize, TSO file send option 4-40 
Browsing a window 2-19 
Buffered mode 4-6 

c 

Ganc^l file transfer 4-22,5-18 
Capturing graphics 2-28 
Gaptuiihg screen text 2-28 
Case mode 
changing 2-19 
status ^^bol for 2-13 
Character case 

changing case mode for 2-19 
GIGS 

definition of 4-3 

receiving files in foreground 4-51 
sending files in foreground 4-48 
GMS 

and VM operating system 5-3 
definition of 4-3 

downloading files (editor-based) 5-13 
editor-ba^d file transfer 5-1,5-4 
filename 5-10 

filename spedfications 4-12,4-19 
messages, turning off and on 4-9,5-4 
parameters for file receive 4-19 
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parameters for file send 4-12,5-10 
preparing for editor-based file transfer 5-5 
receiving files from mainframe 4-17 
receiving files in the foreground 4-30 
sending files to mainframe 4-10 
transferring files in 4-9 
turning off messages during transfer 4-25 
uploading files (editor-based) 5-6 
CMS EDITOR DOWNLOAD 5-14 
CMS EDrrOR'UPLOAD 5-7 
GMSXEDIT 5-3 

Color, changing base color of window 2-20 
Commands 

(see also File Transfer) 
for printing 3-7 
representation in manual xv 
Goncurrent-PG 2-21 
Connection 
meaning of 1-6 
methods xi 

Control units, definition of 1-6 
Controller, definition of 1-6 
Conversational Monitor System (see CMS) 
Copying data between sessions 2-31 
Copying data notes 2-35 
Copying to a mainframe window 2-33 
Copying to a PC window 2^33 
Grlf 

CICS file transfer option 4-52 
CMS file receive option 4-33 
CMS file send option 4-28 
ISO file receive option 4-46 
TSO file send option 4-40 
Cursor 

changing style of 2-20 
location of 2-14 
moving within window 2-19 
Customer Information Control System (see 
CICS,.PS/CICS) 
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/D 

CICS file transfer option 4-55 
CMS file send option 4-29 
Datasetname 

fully>-qualified 4-13,5-9 
TSO file send parameter 5-8 
used in TSO file send 4-13 
DGDF=dcd£name, CICS file transfer option 
4-53 

Del key 2-26 
Delete 

CICS file transfer option 4-53 
DPT mode 

and file transfer 4-7 
using for PS/GIGS file transfer 4-56 
Dicing 

automatic with Autolink A-7 
for SDLC connection A-6 
DISOSS 

file transfer (see PS/CICS) 

IBM program 4-4 
library 4-60 
network 4-55 
Display screen support xii 
Display terrnihals, definition of 1-5 
Documentation Feedback Card xvii 
Downloading fiOies 
definition of 5-4 

TSO and CMS (editor-based) 5-13 

E 

EBCDIC, used for mainframe files 4-52 
Editor 

for notepad windows 2-25 
keys for, notepad 2-26 
Editor-based file transfer 5-1 
End key 2-26 

Enlarge a session window 2-8 
Enlarging a window 2-18 
Error Level 4-61 
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Error messages 

during file transfer 4-60 
with SDEG A41 
Exiting EXTRAl 2-9 
Exporting PS/GIGS files 4-59 
Extended Data Stream 4-6 

using with PS/OGS file transfer 4-56 
EXTRA! 

features of viii 
general use of 2-1 
LM (Low Memory) 2-3 
main menu 2-6 
purpose of vii 
quitting 2-9,2-23 
requirements for using 2-3 
starting 2-4 
unloading part of 2-24 
using Quick Help 2-8 


F 

E2 key 2-26 

Features 

connection methods xi 

copying data between sessions 2-31 

file transfer x 

for display screen xii 

Host Graphics Option xii 

keyboard support xii 

keyboard templates xii 

mouse support xii 

multiple sessions viii 

ofE>CrRAI viii 

printrto*disk ix 

printer emulation ix 

screen capture 2-28 

voice synthesizer support xiii 

windo wing ix 

Field 

definitibnof 2-33 
definition of xvi 
structured 4r6 


File transfer (editor-based) 
cancelling 5-11 
GMS parameters 5-10 
downloading 5-13 

parameters used for TSO receive 5-15 
parameters used for TSO send 5-8 
size of files 5-19 
status display for 5-11 
tips 5-19 
uploading 5-6 
Pile transfer (host-based) 

(see also Trfltts/er) 

background and foreground compared 
4-4,4-8 

cancelling 4-22 

GIGS 4-48 

GIGS options 4-52 

GMS receive options 4-33 

G^^ send options 4-28 

command syntax standards 4-24,4-35 

importing to PS/GIGS 4-60 

of two files simultaneously 4-8 

parameters used for G^^ receive 4-19 

parameters used for GMS send 4-12 

parameters used for TSO receive 4-19 

parameters used for TSO send 4-13 

preparing for 4-3 

receiving from mainframe 4-17 

receiving in GIGS foreground 4-51 

receiving in GMS foreground 4-30 

receiving in TSO foreground 4-42 

sending to mainframe 4-10 

status di^lay for 4-14,4-21 

structured fields vs. buffered transfer 4-6 

TSO 4-36 

TSO receive options 4-45 
TSO send options 4-39 
File transfer 
definition of x 
editor-based 5-1 
host and editor compared 4-4 
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host-based 4-1 
Filemode 

GMS file receive option 5-16 
GMS file send option 5-10 
u^d in CMS file receive 4-19 
used in CMS file send 4-12 
Filename 

CMS file receive parameter 5-16 
GMS file send parameter 5-10 
used in CMS file receive 4-19 
used in CMS file send 4-12 
used in TSO file send 4-13,5-8 
used in TSO file transfer 4-19 
Files 

editor-based transfer of 5-1 
exporting from PS/CIGS 4-59 
host-based transfer of 4-1 
notepad 2-27 

size for editor-based transfer 5-19 
Filetype 

GMS file receive parameter 5-16 
GMS file send parameter 5-10 
used in CMS file receive 4-19 
used in GMS file send 4-12 
Final Form text documents 4-59 
Floppy disk system^ starting EXTRA! 2-5 
F0R-USIDN,GIGS file transfer option 4-53 
Foregrotmd file transfer 

compared with background 4-5 
not in editor-based 5-19 
using with GIGS 4-47 
using with CMS 4-23 
using with TSG 4-34 

FROM=USID, GICS file transfer option 4-53 
Full-screen mode 2-8 
Fully-qualified datasetname 4-13,5-9 

G 

Gateway, checking assignments of A-3 
Graphic program support xii 


Graphics 

capturing 2-28 
mode 2-35 

H 

Hard disk S 5 ^temi 
starting EXTRA! 2-5 
Help 

using on-line 2-22 
using Quick Help 2-8 
Home key 2-26 
Host> (see Mainframe) 

Host Graphics Option xii 
Host-based 
definition of 4-4 
file transfer 4-1 

HTF, GIGS file transfer option 4-53 

I 

Importing files to PS/GICS 4-60 
IMDSFILE 

and Send/Receive 4-1 
new name 4-8 
used for file transfer 4-6 
INFO File xviii 
Information Utility File xviii 
Ins key 2-26 
Insert mode 2-26 

j 

Jump 

between PG and mainframe 2-7 
to a specific session 2-12 
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KEEP, GIGS file transfer option 4-53 
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Keyboard override 

using with Autolink A^8 
using with LAN AS 
Keyboard support xii 
Keyboard templates xii 
Keys 

editing, for notepad 2-26 
representation in manual xv 
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LAN connection 

checking gateway assignments A-3 
checking mainhame sessions A-2 
starting up A-2 

tiuiung sessions on and off A^ 
Layout, of windows on saeen 1-8 
LM (Low Memory) 

data copying unavailable 2-31 
defined 2-3 

not jumping between sessions 2-11 
notepad not available 2-25 
omlihe help not available 2-22, 
screen capture not available 2r2B 
windowing not available 2-16 
Local Area Network connection (see LAN 
a^nnection) 

LogicalUnit lype 1 (seelUI) 

Logical Unit Type 3 (see LU3) 

Long name of session 2-11 
Lredn 

CMS file send option 4-29 
TSO file send option 4-40 
LU, checking assignments A-3 
LUl 

monitoring print job 3-8 
printer session 3-4 
using PA keys 3-11 
LU3, printer session 3-3 


M 

Mainframe 

accessing sessions on 2-11 
controllers 1-6 
definition of 1-6 
GIA S 3 mibols defined 2-13 
printing 3-5 

sample print commands 3-7 
session 1-6 
status of session 2-12 
Mainframe session 

checking gateway assignments A-3 
cheddhg, on a LAN A-2 
Manual 

conventions xv 
requirements for using xiv 
using XV 

Manuals, others for EXTRA! xiv 
Member 

TSO file receive option 5-15 
TSO file send option 5-8 
used in TSO file receive 4-19 
usedin TSO file send 4-13 
Memoiy-saving memory 2-24 
Modem, ty|^ required for SDLC A-5 
Monitois, models emulated 1-5 
Mouse support! xii 
Moving cursor in window 2-19 
Multiple sessions 1-7 
Multiple Virtual Storage (MVS) 4-3 
MVS operating system 5-3 

N 

Network 

starting up with a LAN A-2 
type of connection 2-3 
Network Gonnection Menu A-6 
NLS«nn> GIGS file transfer option 4-54 
NOCRLF, GIGS file transfer option 4-54 
NOREPLAGE, GIGS file transfer option 4-54 
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Notepad 

displa 3 dng file in 2-27 
editing commands 2-26 
editor 2-25 

files, saving and retrieving 2-27 
windows 2-25 

o 

OFFLINE message in OIA 3-10 
OIA 

and printer emulation 3-9 
and windowing 2-12 
definition of symbols 2-13 
printer messages 3-5 
showing status of session 2-12 
One-Time screen capture 2-28 
Operator Information Area (OIA) 2-12 
Operator Information Area (see OIA) 
Options 

for OGS file transfer command 4-52 
for CMS receive command .4-33 
for GMS send command 4-28 
for TSO receive command 4-45 
forTSO send command 4-39 
Options field 5-16 
Overwrite 

avoiding on window 2-20 
mode 2^26 

p 

PA keys 3-11 
Packet Mze 

CMS file receive option 4-34 
CMS file send optidn 4-29 
TSO file receive option. 4-46 
TSO file send option 4-41 
Parameters 

CMS file send 5-10 
used for CMS file receive 4-19 
used for CMS file send 4^12 
used for tSO file send 4-13,5-8 


used for TSO file transfer 4-19 
Partitioned data set 4-13,4-19 
Partitioned data set 5-8 
Password 

read-protectionln TSO file receive 4-20, 
4-45,5-15 

write-protection in TSO file send 4-13, 
4-39,5-8 

Path command support 4-61 
PC session 1-6 
PFkeys xv 

Phone number, selecting for SDLC connection 
A -6 

Print-to-disk feature 3-3 
Printer emulation; 

and screen capture 3-10 
before you begin 3-4 
checking a print job 3-8 
definition of 3-3 
ending 3-10 
LUl session 3-4 
LU3 session 3-3 
menu* 3-10 
session; 3-3 

status mformation 2-14 
status messages 3-9 
turning on and off 3-5 
using 3-5 

using PA keys 3-11 
Printer session^ turning on and off 3-5 
Printers, supported 1-5 
Printing 

APL characters 2^36 
OIA messages during 3-5 
to disk 3-3 
Printing fil^ 3,5 
Printing mainframe files 3-5 
PRIVATE, CIGS file transfer option 4-54 
Ptogram Attention keys 3-11 
Protocol 

checking, for a LAN connection A-3 
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PS/CIGS 

(see also Transfer (DISOSS)) 
choosing file transfer defaults 4-56 
exporting files to PG 4-59 
file transfer 4-55 
importing files to 4-60 
requirements for file transfer 4-55 
PS/GiGS Transfer 44 
PUBLIC, GIGS file transfer option 4-54 
PtibEcations xx 
Purpose of EXTRA! vii 
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Quick Help 2^8 
Quick Reference Card xvi 
Quitting EXTRA! 2-9,2-23 
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Readiness message 2-13 
Ready prompt 4-26, 4-30, 4-37 
Receiving files 
GiGS options 4-52 
CMS command line defined 4-32 
CMS options 4-33 
in GIGS foreground 4-47 
in GMS'foreground 4-24 
in the background 447 
in the TSG foreground 4-34 
TSO command line defined 4-44 
TSQ options #45 
Recfm 

CMS file send option 4-29 
TSO file send option 1 4-40 
Record 

definition of 5^20 
length 5-20 

References for additional information xx 
Registration card xviii 
Remote mnnectidn 

with Autolihk/SDLG A-7 
wilh SDLG A-5 


REPLACE, GIGS file transfer option 4-54 
Resource Requested screen A-4 
Resource, selecting A-3 
Retrieving notepad files 2-27 
Revisable Format text documents 4-59 
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GIGS file transfer option 4-54 
CMS file receive option 4-34 
CMS file send option 4-29 
TSG file receive option 4-46 
TSO file send option 4-41 
Saving notepad files 2-27 
Screen 

avoiding overwrite 2-20' 
capturing text 2-28 
changing layouts 2^17 
layout 1-8 
layouts 2-17 
sizes and colors 1-5 
Screen capture 

and printer emulation 3-10 
definition of 2-28 
displaying saved screen 2-30 
ending 2-31 
one-time feature 2^28 
printing saved screen 2-30 
to disk 2^29 
using 2-28 

Scroll lock status 2-14 
SDLG connection 
error messages A-11 
modem used with A-5 
starting A-5 

turning sessions on and off A-4 
with AutoMtik A-5 
Send/Receive 4-6 
Sending files 

GIGS command line defined 4-49 

GIGS optibns 4-52 

CMS command line defined 4-27 
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CMS options 4-28 
in CIGS foreground 4^47,4-48 
in GMS foreground 4-25 
Sending files (continued) 
in the background 4-10 
in the GMS foreground 4-24 
in the TSO foreground 4-34 4-36 
TSO command Ine defined 4-38 
TSO options 4-39 
Sessions 

(see also Mainframe session, PC session) 
accessing on mainframe 2-11 
advancing to next 2-11 
cop 3 dng data between 2-31: 
definition of 1-6 
for printer emulation 3-3 
jumping between 2-7 
long name of 2-11 
LUl printing 3'r4 
LU3 printing 3-3 
monitoring status of 2-12 
multiple, defined viii 
short name of 241 
turning on and off 2^15 
viewing multiple windows 2-8 
Short name of session 2-11 
Shrinking a window 2-18 
Size of files for transfer 5-19 
Space, TSO file send option 4-41 
Starting EXTRA! 2-4 
Startup 

conditions with Autolihk A-10 
LAN connection! A-2 
screen 2-6 

Station, checking name of A-3 
Status 

checking, for print job 3-8 
of file transfer 4-16, 4-22 
of file transfer 5-12 
of print job 2-14 
of session 2-12 
Structured fields 4-6 


Synchronous Data Link Control 
(see SDLC conn&:dion) 
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Templates, for keyboard xvii 
Terminal emulation 
advanta^sof 1-3 
definitibnof 1-3 
Terminal On/Off setting 
definition of A-7 
effect on Autolink A-7 
Terminal Sesaon Off message A-4 
Terminals, models emulated 1-5 
Text files 

editor-based file transfer 5-1 
host-based file transfer 4-4 
Time Sharing Option (see TSO) 

Transfer (DISOSS) 

(see also FS/GJCS) 
automatic loading 4-57 
manual loading 4-58 
PG memory used 4-59 
setting up 4-56 
Transfer 

loading for PS/CICS file transfer 4-55 
Transfemng files 
editor-based 5-1 
host-based 4-1 
simultaneously 4-8 
TS, GIGS file transfer option 4-54 
TSO 

and MVS operating system 5-3 
definition of 4-3 

downloading files (editor-based) 5-13 
editor-based file transfer 5-1 
filename 4-13/ 4-19 
filename 5-8 

parameters for file send 4-13/ 5-8 
parameters for file transfer 4-19 
receiving files from mainfiame 4-17 
receiving fUes in the foreground 4-42 
sending files to mainframe 4-10 
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transferring files in 4-9 
uploading files (editor-based) 5-6 
TSO EDrr 5-3 

TSO EDITOR DOWJliOAD 5-14 
TSO EDITOR UPLOAD 5-7 
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Uploading files 
definition of 5-4 

TSO and CMS (editor-based) 5-6 


viewing together 2-8, 2-16 
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3270 

meaning 1-4 
tenninal emulation 1-3 
terminal keys xvii 
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mainframe printer 3-1 
printer family supported 1-5 
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Viewing session windows 2-8 
Virtual Machine (VM) 4-3 
VM operating system 5-3 
Voice synthesizer support xiii 
VTAM (Virtual Teleconununicatibns Aa^ess 
Method) 1-6 
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Window 

avoiding overwrite 2-20 
browsing 2^19 
changing base color of 2-20 
enlarging 2-18 
for notepad 2^25 
identification of 2-12 
layout number 2*^13 
long name 2-11, 2-13 
moving cursor in 2-19 
short name 2-11,2-13 
shrinking 2-18 
Windowdng 
definition of ix 
using 2-8 
Windows 

changing screen layout 2-17 
cop 5 dng data between 2-31 
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kyoutof on saeen^ 1-8 
size and number 1-7 
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